{"uid":"cap_oilI-A6t-IG66Y4w46UPf","slug":"us-brand-federal-award-snapshot-bc47b1a2","name":"US Brand Federal Award Snapshot","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/us-brand-federal-award-snapshot","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"endDate":{"$ref":"#/definitions/bazaarShared0"},"requestId":{"type":"string","pattern":"^[A-Za-z0-9._:-]+$","maxLength":80,"minLength":1},"startDate":{"$ref":"#/definitions/bazaarShared0"},"maxResults":{"type":"integer","maximum":25,"minimum":1},"recipientId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-C$"}}},"responseSchema":{"type":"json","example":{"meta":{"run_ms":1200,"settled":true,"item_count":1},"results":[{"actor":"us-brand-federal-award-snapshot","found":true,"awards":[{"awardId":"19FR6326K0799","awardType":"PURCHASE ORDER","actionDate":"2026-07-30","internalId":"360959545","recipientId":"09c94e6e-003f-7a9a-a6a9-2305eb5b6025-C","modification":"0","recipientUei":"HJAKCN4NEU95","recipientName":"APPLE INC","awardingAgency":"Department of State","awardingSubAgency":"Department of State","transactionAmount":15236.93,"generatedInternalId":"CONT_AWD_19FR6326K0799_1900_-NONE-_-NONE-"}],"window":{"endDate":"2026-08-04","startDate":"2026-07-01"},"partial":false,"queriedAt":"2026-08-05T08:31:38.839Z","recipient":{"uei":"HJAKCN4NEU95","name":"APPLE INC","detailUrl":"https://api.usaspending.gov/api/v2/recipient/09c94e6e-003f-7a9a-a6a9-2305eb5b6025-C/","recipientId":"09c94e6e-003f-7a9a-a6a9-2305eb5b6025-C","recipientLevel":"C","attributionStatus":"verified_by_exact_recipient_id_and_uei"},"requestId":"prefill-apple-contracts-2026-08","sourceAsOf":"2026-08-05","resultCount":1,"sourceStats":{"attempts":3,"operations":3,"decodedBytes":2036},"schemaVersion":"1.0","sourceAsOfRaw":"08/05/2026","deliveryIntent":{"event":"result-found","businessRows":1}}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9RYWf-VJj5jg4pC1x1gOl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent US federal contract/purchase-order awards for a named brand or company within a specified date window, sourced from USASpending.gov","exampleAgentPrompt":"Can you pull the recent federal contract awards for Apple from July 1 to August 4, 2026? I want to see which government agencies awarded them contracts and for how much.","exampleUseCases":[{"title":"Monitor competitor government contracts","prompt":"What federal contracts has Microsoft been awarded in the last 30 days? I want to see which agencies are buying from them and the dollar amounts."},{"title":"Vendor due diligence on federal exposure","prompt":"We're evaluating Palantir as a supplier — can you check what US federal awards they've received recently so I can understand their government revenue exposure?"},{"title":"Compliance check on award activity","prompt":"Pull any federal purchase orders awarded to Booz Allen Hamilton between July 1 and July 31, 2026 — I need the awarding agency, award type, and transaction amounts for our compliance report."}],"resultDescription":"Returns a JSON object containing an array of federal award records for the queried brand, each including award ID, award type, action date, transaction amount, awarding agency, sub-agency, recipient UEI and name, modification number, and a generated internal ID. Also includes metadata such as total result count, query window, source freshness timestamp, attribution status, and processing stats (run time, item count, whether results are partial).","failureModes":["Brand/company not found in USASpending.gov — 'found: false' with empty awards array","No awards in the specified date window — result count of 0","Partial results flag set to true if data retrieval was incomplete","USASpending.gov upstream timeout causing increased run_ms or failed attempts","Invalid UEI or brand name causing unresolvable recipient lookup","Payment not settled — x402 payment flow fails before data is returned"],"whenToPreferThis":"Choose this endpoint when you need a quick, structured snapshot of recent US federal procurement awards for a specific brand or company without building your own USASpending.gov integration. It is especially useful for competitive intelligence, vendor due diligence, grant/contract monitoring, or compliance reporting workflows where you need per-company award data on demand at low cost ($0.05/call). Prefer it over direct USASpending.gov API calls when you want a normalized, agent-friendly JSON response with attribution verification and source freshness metadata already resolved.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:38:56.443Z","isFirstParty":false}