{"uid":"cap_v085ob9YK1cJtTJ6wigt7","slug":"bidhatch-government-contracts-awards-api-3b165536","name":"BidHatch Government Contracts Awards API","description":"Open federal government contracts for box truck owners, couriers, janitorial, landscaping, pest control, moving and HVAC small businesses. Updated daily from SAM.gov.","url":"https://bidhatch.pages.dev/api/v1/awards?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"Keyword in award description"},"psc":{"type":"string","description":"PSC code(s)"},"sort":{"type":"string","description":"amount (largest first) or date (most recently modified first)"},"limit":{"type":"string","description":"1-100, default 25"},"naics":{"type":"string","description":"NAICS code(s) or prefix, comma-separated. Covered: trade codes 4841xx-4842xx, 488510, 4921xx-4922xx, 5617xx, 238210, 238220, 238990, 811310"},"since":{"type":"string","description":"Award start date on/after YYYY-MM-DD"},"state":{"type":"string","description":"Place-of-performance state(s), 2-letter"},"until":{"type":"string","description":"Award start date on/before YYYY-MM-DD"},"agency":{"type":"string","description":"Awarding top-tier agency name, e.g. Department of Veterans Affairs"},"offset":{"type":"string"},"recipient":{"type":"string","description":"Recipient (contractor) name or UEI text"},"min_amount":{"type":"string","description":"Minimum award amount in dollars"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":1,"results":[{"end":"2026-08-31","psc":"S201","naics":"561720","start":"2021-02-10","agency":"Department of Defense","amount":3762690.13,"award_id":"W9115121C0003","pop_state":"TX","recipient":"EXAMPLE FACILITY SERVICES LLC","sub_agency":"Department of the Army","description":"INSTALLATION CUSTODIAL SERVICE","recipient_uei":"ABCDEFGH1234","usaspending_url":"https://www.usaspending.gov/award/CONT_AWD_..."}],"has_next":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oABy1Ovu0Gaq7WpxE5wHE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and retrieve open federal government contract award records filtered by trade, industry, state, agency, and other criteria, updated daily from SAM.gov","exampleAgentPrompt":"Find me open federal government contracts for janitorial or custodial services in Texas — sort by largest amount first and show me the top 10 results.","exampleUseCases":[{"title":"Box truck owner finding delivery contracts","prompt":"Can you search for federal courier or box truck delivery contracts in Virginia awarded since January 2024? Show me up to 25 results sorted by the most recent first."},{"title":"HVAC contractor researching government bids","prompt":"Find me federal HVAC contracts awarded by the Department of Veterans Affairs — I want to see the biggest ones first and focus on awards of at least $50,000."},{"title":"Landscaping business spotting new opportunities","prompt":"Look up open government landscaping contracts in Florida using BidHatch and give me the top 20 most recently modified ones so I can see what's active."}],"resultDescription":"Returns a JSON object with a count of matching records, a has_next pagination flag, and a results array. Each result includes the award ID, recipient name and UEI, award amount in dollars, description, NAICS and PSC codes, awarding agency and sub-agency, place-of-performance state, contract start and end dates, and a direct link to the USASpending.gov award page.","failureModes":["Invalid NAICS or PSC code returns empty results rather than an error","Date format not matching YYYY-MM-DD may return unexpected results or errors","State codes not matching 2-letter abbreviation format may fail filtering","Limit values outside 1-100 range may be rejected or clamped","No results matching filters returns count:0 and empty results array","Payment failure (402) if USDC payment not provided or insufficient"],"whenToPreferThis":"Choose this endpoint when you need to search federal government contract awards specifically targeted at owner-operators and small businesses in trade industries like trucking, janitorial, landscaping, pest control, moving, HVAC, and courier services. It is preferable over raw SAM.gov queries because it is pre-filtered for these specific NAICS codes, updated daily, and returns clean structured JSON with direct USASpending links. Use it when you need to filter by state, agency, date range, or minimum dollar amount for small business procurement discovery.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-03T18:30:49.014Z","isFirstParty":false,"canonicalSlug":"bidhatch-government-contracts-awards-api-3b165536"}