# GovParse Federal Award Search

> GovParse Federal Award 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 contract and assistance award history by recipient, agency, NAICS, CFDA, amount range, and date window

## Facts

- Endpoint: GET https://api.govparse.io/v1/awards/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-federal-award-search-f6d4188f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aUAxOCGUPVmdj_00ctKpg

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-federal-award-search-f6d4188f
```

Example prompt: Can you pull up all federal contracts awarded to Lockheed between October 1 2024 and July 16 2025, minimum $1 million, sorted by amount descending, and show me the top 25?

## When to prefer this

Choose this endpoint when you need to search historical federal award data — contracts and/or grants — across multiple filter dimensions simultaneously (recipient, agency, NAICS, CFDA, amount, date). Prefer it over raw USAspending API calls for its simplified parameter model and x402 micropayment access. Best for competitive intelligence, incumbent identification before recompetes, grant winner analysis, and spend research by agency or program. Not suited for finding open solicitations (use the sibling opportunities endpoint) or real-time contract status.

## Known failure modes

- No results returned when recipient name fragment does not match any record
- Invalid UEI format returns an error or empty result set
- CFDA number not found if entered incorrectly or for non-assistance awards
- Amount range too narrow returns zero results
- Date range outside available data window returns empty set
- Pagination offset beyond total results returns empty array
- Invalid sort field returns an error

## How this service works

Who has the government actually paid, for what, and how much? Search USAspending federal award history (contracts and assistance) by recipient name or UEI, awarding agency, NAICS prefix, CFDA number, amount range, and action-date window — competitor award research, incumbent lookup before a recompete, and grant-winner analysis in one call.

## Output

Returns paginated rows of federal award records from USAspending, each including recipient name, UEI, award amount, awarding agency, action date, award type (contract or assistance), NAICS code, CFDA number, and related identifiers — ready for competitive analysis, incumbent research, or grant landscape review.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [],
   "properties": {
    "uei": {
     "type": "string",
     "examples": [
      "ZQGD2Xix75A5"
     ],
     "description": "Recipient Unique Entity Identifier (SAM UEI), exact match."
    },
    "cfda": {
     "type": "string",
     "examples": [
      "93.243"
     ],
     "description": "CFDA / Assistance Listing number, exact match (assistance awards)."
    },
    "kind": {
     "type": "string",
     "examples": [
      "contract"
     ],
     "description": "contract | assistance (grants, loans, direct payments). CSV for both."
    },
    "sort": {
     "type": "string",
     "examples": [
      "action_date:desc"
     ],
     "description": "field:direction — amount | action_date. Default 'amount:desc'."
    },
    "limit": {
     "type": "integer",
     "examples": [
      25
     ],
     "description": "Max rows (default 25, cap 100)."
    },
    "naics": {
     "type": "string",
     "examples": [
      "5415"
     ],
     "description": "NAICS code prefix(es), CSV."
    },
    "agency": {
     "type": "string",
     "examples": [
      "defense"
     ],
     "description": "Awarding agency or sub-agency name fragment. Example: 'defense'."
    },
    "offset": {
     "type": "integer",
     "examples": [
      0
     ],
     "description": "Rows to skip, for paging."
    },
    "recipient": {
     "type": "string",
     "examples": [
      "lockheed"
     ],
     "description": "Award recipient name fragment. Example: 'lockheed'."
    },
    "amount_max": {
     "type": "number",
     "examples": [
      50000000
     ],
     "description": "Maximum award amount in USD."
    },
    "amount_min": {
     "type": "number",
     "examples": [
      1000000
     ],
     "description": "Minimum award amount in USD."
    },
    "awarded_after": {
     "type": "string",
     "examples": [
      "2025-10-01"
     ],
     "description": "Action date on or after (YYYY-MM-DD)."
    },
    "awarded_before": {
     "type": "string",
     "examples": [
      "2026-07-16"
     ],
     "description": "Action date on or before (YYYY-MM-DD)."
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/govparse-federal-award-search-f6d4188f/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)
