# GovParse Subawards Search

> GovParse Subawards Search is a paid API for AI agents from api.govparse.io, paid per call via x402, $1.25/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: GET https://api.govparse.io/v1/subawards/search
- Price: $1.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/govparse-subawards-search-0aaa40f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MGtLBaeo8AG_elUo8_hRL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability govparse-subawards-search-0aaa40f3
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": [
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/govparse-subawards-search-0aaa40f3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.govparse.io](https://www.zero.xyz/host/api.govparse.io/llms.txt)