# USASpending Federal Awards Search

> USASpending Federal Awards Search is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Search and filter awarded US federal contracts and grants from USASpending.gov by type, recipient, agency, NAICS code, keyword, and fiscal year, returning a normalized award list with summary.

## Facts

- Endpoint: GET https://payai.agentstools.dev/govcon/awards
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usaspending-federal-awards-search-692f2ff0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qy8oqINxPk-MLIUQMyJ2u

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-federal-awards-search-692f2ff0
```

Example prompt: Search USASpending for federal contracts awarded in fiscal year 2024 by the Department of Defense to Lockheed Martin, sorted by amount descending — show me the top 20 results.

## When to prefer this

Use this endpoint when you need to search US federal contract and grant award data from USASpending.gov with flexible filtering by award type, recipient, agency, NAICS, keyword, or fiscal year. Prefer this over scraping USASpending directly or using broader government data APIs when you need normalized, paginated award results with a summary in a single API call.

## Known failure modes

- No results returned when filters are too restrictive or no matching awards exist
- Invalid NAICS code format returns validation error
- Invalid award_type enum value returns error
- Fiscal year out of available data range returns empty or error
- Pagination beyond available results returns empty list
- Agency name not matching USASpending canonical names returns no results

## How this service works

Search awarded US federal contracts and grants from USASpending.gov, filtered by award type, recipient, agency, NAICS, keyword and fiscal year, returning a normalized award list plus a summary.

## Output

A normalized list of federal awards including award amounts, dates, recipient names, awarding agencies, and NAICS codes, along with an aggregate summary of matching awards (total obligations, count, etc.).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "page": {
       "type": "integer",
       "minimum": 1
      },
      "sort": {
       "enum": [
        "amount",
        "date"
       ],
       "type": "string"
      },
      "year": {
       "type": "integer",
       "description": "Federal fiscal year"
      },
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1
      },
      "naics": {
       "type": "string",
       "description": "NAICS code, 2-6 digits"
      },
      "order": {
       "enum": [
        "desc",
        "asc"
       ],
       "type": "string"
      },
      "agency": {
       "type": "string"
      },
      "keyword": {
       "type": "string"
      },
      "recipient": {
       "type": "string"
      },
      "award_type": {
       "enum": [
        "contracts",
        "direct_payments",
        "grants",
        "idvs",
        "loans",
        "other"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usaspending-federal-awards-search-692f2ff0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)