# USASpending Awards Search API

> USASpending Awards Search API is a paid API for AI agents from project-api-gamma-sable.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Search and retrieve US federal government contract and grant award records from USASpending.gov, filtered by date range, NAICS code, award type, and awarding agency.

## Facts

- Endpoint: GET https://project-api-gamma-sable.vercel.app/paid/usaspending/awards?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usaspending-awards-search-api-2042cf8b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Iiti8bW-atG7j22YP9ilM

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 usaspending-awards-search-api-2042cf8b
```

Example prompt: Pull federal contract awards from USASpending from January 1 2024 to March 31 2024, filtered by NAICS code 541511 (custom computer programming) and awarded by the Department of Defense — show me the first 10 results.

## When to prefer this

Choose this endpoint when you need programmatic access to US federal government award data (contracts and grants) with x402 micropayment support, and want slim filtered JSON rather than scraping USASpending.gov directly. Especially useful for agents that need date-range queries, NAICS filtering, or agency-specific lookups at low per-call cost ($0.01 USDC).

## Known failure modes

- HTTP 402 if payment is not provided — requires USDC on Base via x402 protocol
- Missing required startDate or endDate parameters returns a validation error
- Invalid date format (not YYYY-MM-DD) may cause malformed query
- Invalid or unsupported NAICS code may return empty results
- Pagination beyond available results returns empty items array
- USASpending.gov upstream downtime may cause delayed or failed responses

## How this service works

Paid public-data feeds. Unpaid requests return HTTP 402. Prices are USDC on Base.

## Output

Returns a slim JSON object with an array of federal award items matching the query, plus a source path and a UI link pointing to the corresponding USASpending.gov search page for human review.

## Request schema (JSON Schema)

```json
{
 "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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "startDate",
      "endDate"
     ],
     "properties": {
      "page": {
       "type": "string",
       "description": "Page number"
      },
      "limit": {
       "type": "string",
       "description": "Max results"
      },
      "naics": {
       "type": "string",
       "description": "Query param: naics"
      },
      "endDate": {
       "type": "string",
       "description": "End date (YYYY-MM-DD)"
      },
      "awardType": {
       "type": "string",
       "description": "Query param: awardType"
      },
      "startDate": {
       "type": "string",
       "description": "Start date (YYYY-MM-DD)"
      },
      "awardingAgency": {
       "type": "string",
       "description": "Query param: awardingAgency"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "what": "USASpending.gov award search (slim JSON + uiLink)",
  "items": [],
  "source": "/paid/usaspending/awards"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usaspending-awards-search-api-2042cf8b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from project-api-gamma-sable.vercel.app](https://www.zero.xyz/host/project-api-gamma-sable.vercel.app/llms.txt)