# GovParse Subaward Bulk Feed

> GovParse Subaward Bulk Feed is a paid API for AI agents from api.govparse.io, paid per call via x402, $25/call, status unknown (last checked 2026-09-15).

Returns a paginated bulk feed of federal subawards from USAspending, filterable by state, NAICS, agency, amount, and date, with an option to isolate first-time subawardees.

## Facts

- Endpoint: GET https://api.govparse.io/v1/feeds/subawards
- Price: $25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/govparse-subaward-bulk-feed-9cca760d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XGDuEoqupDqusIIG-m24J

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-subaward-bulk-feed-9cca760d
```

Example prompt: Pull the latest federal subawards for IT services companies — NAICS prefix 5415 — in Texas, limit 500 rows per page, only show first-time subawardees with a minimum award of $50,000, and start from June 1, 2026.

## When to prefer this

Choose this endpoint when you need bulk, paginated access to federal subaward data — especially to identify first-time subawardees or new entrants to government contracting. It is purpose-built for the prime-to-sub cascade (File F data) and supports filtering by state, NAICS, agency, amount, and date in a single flat-row format. Prefer this over prime award feeds when your focus is downstream subcontract flow rather than top-level awards, and over point-lookup endpoints when you need systematic, scrollable coverage of recent activity.

## Known failure modes

- Invalid or expired cursor returns a 400 error or empty result set
- Unsupported NAICS prefix format returns no results or validation error
- Overly broad filters with no results return an empty rows array
- Since date in wrong format (not YYYY-MM-DD) causes a 400 parse error
- min_amount as non-integer causes schema validation failure
- Rate limiting or payment issues (x402) return a 402 Payment Required response
- Very recent data may not yet be reflected due to USAspending filing lag

## How this service works

Which companies just received a federal subaward — and which are getting their FIRST one? Bulk feed over USAspending subawards (the File F prime→sub cascade), newest-first by action date: sub-recipient, prime, agency, amount (banded), NAICS, and date. new_only isolates first-time subawardees (no prime award on record) — the new-to-govcon growth signal. Flat rows, cursor-paginated up to 1000/page, filterable by state, NAICS, agency, minimum amount, or since. Observational public records as filed.

## Output

Flat rows of subaward records (up to 1000 per page), each containing sub-recipient name, prime awardee, awarding agency, banded subaward amount, NAICS code, and action date, plus a next_cursor for pagination and a flag indicating whether the sub-recipient is a first-time subawardee with no prior 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": {
    "limit": {
     "type": "integer",
     "examples": [
      500
     ],
     "description": "Rows per page (default 500, cap 1000)."
    },
    "naics": {
     "type": "string",
     "examples": [
      "5415"
     ],
     "description": "NAICS code prefix(es), CSV."
    },
    "since": {
     "type": "string",
     "examples": [
      "2026-06-01"
     ],
     "description": "Only subawards with an action date on or after this date (YYYY-MM-DD)."
    },
    "state": {
     "type": "string",
     "examples": [
      "TX"
     ],
     "description": "Place-of-performance state code(s), CSV."
    },
    "agency": {
     "type": "string",
     "examples": [
      "health"
     ],
     "description": "Awarding agency or sub-agency name fragment."
    },
    "cursor": {
     "type": "string",
     "examples": [
      "eyJkIjoiMjAyNi0wNy0yMiIsImsiOiJmNTc5NjI1ZiJ9"
     ],
     "description": "Opaque page cursor — pass the previous page's next_cursor unchanged."
    },
    "new_only": {
     "type": "string",
     "examples": [
      "true"
     ],
     "description": "true = only first-time subawardees (sub-recipients with NO prime award on record)."
    },
    "min_amount": {
     "type": "integer",
     "examples": [
      50000
     ],
     "description": "Minimum subaward amount in USD."
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/govparse-subaward-bulk-feed-9cca760d/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)