{"uid":"cap_MGtLBaeo8AG_elUo8_hRL","slug":"govparse-subawards-search-0aaa40f3","name":"GovParse Subawards Search","description":"When a prime wins federal work, who does it flow subcontracts and subgrants down to? Search USAspending subawards (File F prime → sub cascade) by sub-recipient or prime name/UEI, prime award id, awarding agency, NAICS, PSC, subaward type (contract/grant), place-of-performance state, amount, or action date. Set new_subawardee=true for first-time subawardees — subs with NO prime award on record, coming up through subcontracts (a bonding/staffing/lending/teaming lead). Public federal records.","url":"https://api.govparse.io/v1/subawards/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":[],"properties":{"psc":{"type":"string","examples":["R425"],"description":"Product/Service Code(s), CSV — exact."},"sort":{"type":"string","examples":["amount:desc"],"description":"field:direction — amount | action_date. Default 'action_date:desc'."},"type":{"type":"string","examples":["contract"],"description":"contract | grant (sub-contract vs sub-grant). CSV for both."},"limit":{"type":"integer","examples":[25],"description":"Max rows (default 25, cap 100)."},"naics":{"type":"string","examples":["5415"],"description":"NAICS code prefix(es), CSV. Example: '5415' covers all IT services."},"state":{"type":"string","examples":["VA"],"description":"Place-of-performance state code(s), CSV."},"agency":{"type":"string","examples":["navy"],"description":"Awarding agency or sub-agency name fragment. Example: 'navy'."},"offset":{"type":"integer","examples":[0],"description":"Rows to skip, for paging."},"sub_uei":{"type":"string","examples":["ZQGD2XIX75A5"],"description":"Sub-recipient Unique Entity Identifier (SAM UEI), exact match."},"new_since":{"type":"string","examples":["2026-04-01"],"description":"Sub-recipient's FIRST observed subaward on or after this date (YYYY-MM-DD)."},"prime_uei":{"type":"string","examples":["ABC123DEF456"],"description":"Prime recipient Unique Entity Identifier (SAM UEI), exact match."},"amount_max":{"type":"number","examples":[50000000],"description":"Maximum subaward amount in USD."},"amount_min":{"type":"number","examples":[100000],"description":"Minimum subaward amount in USD."},"awarded_after":{"type":"string","examples":["2026-01-01"],"description":"Subaward action date on or after (YYYY-MM-DD)."},"sub_recipient":{"type":"string","examples":["technologies"],"description":"Sub-recipient (subcontractor/subgrantee) name fragment."},"awarded_before":{"type":"string","examples":["2026-07-24"],"description":"Subaward action date on or before (YYYY-MM-DD)."},"new_subawardee":{"type":"string","examples":["true"],"description":"true → only first-time subawardees: subs with NO prime award on record."},"prime_award_id":{"type":"string","examples":["N0003022C2001"],"description":"Prime award PIID / FAIN, exact match — all subs under one prime."},"prime_recipient":{"type":"string","examples":["lockheed"],"description":"Prime recipient name fragment. Example: 'lockheed'."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.25","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":"$1.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ceaYM7mLvbePusApNWhim","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search USAspending federal subaward records (subcontracts and subgrants) by sub-recipient, prime contractor, agency, NAICS/PSC, amount, date, state, and more — including first-time subawardees.","exampleAgentPrompt":"Search for all subcontracts that flowed from Navy prime contractors to IT services subs (NAICS 5415) in Virginia since January 2025, with amounts over $100,000 — and flag any first-time subawardees.","exampleUseCases":[{"title":"Tracing subcontract flow from prime","prompt":"Who did Booz Allen Hamilton flow subcontracts to last year? Search subawards where the prime name is 'Booz Allen' awarded after 2024-01-01, sorted by amount descending, and show me the top 25."},{"title":"Finding first-time federal subcontractors","prompt":"I want to find companies that just received their very first federal subcontract — no prior prime award history — in the cybersecurity space (NAICS 5415) since April 2025. Can you pull that using the new_subawardee filter?"},{"title":"Agency subgrant recipient research","prompt":"Which organizations received subgrants from the Department of Energy in Texas in 2024? Search subawards with agency 'energy', type 'grant', state 'TX', and awarded between 2024-01-01 and 2024-12-31."}],"resultDescription":"Returns a paginated list of subaward records from USAspending File F data, each containing sub-recipient name, UEI, subaward amount, action date, subaward type (contract or grant), prime award details (prime name, UEI, award ID), awarding agency, NAICS and PSC codes, place-of-performance state, and a flag indicating whether the sub-recipient is a first-time subawardee with no prime award on record.","failureModes":["No results returned when name fragment is too generic or misspelled — try UEI for exact match","Invalid date format (not YYYY-MM-DD) returns a validation error","UEI not found if sub-recipient is not registered in SAM.gov","NAICS prefix too broad may return up to the 100-row cap without covering all results — use offset for paging","new_subawardee flag combined with other restrictive filters may yield zero results if no qualifying records exist","PSC code must be exact — partial PSC codes may return no results"],"whenToPreferThis":"Use this endpoint when you need to trace the downstream flow of federal contract or grant dollars from prime awardees to their subcontractors and subgrantees, especially for competitive intelligence, compliance research, small business teaming analysis, or identifying first-time market entrants with no prime award history. Prefer this over prime award search endpoints when the subject of interest is the sub-recipient relationship rather than the direct federal award.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:33.174Z","isFirstParty":false}