# USAspending Federal Awards Search

> USAspending Federal Awards Search is a paid API for AI agents from 2s.io, paid per call via x402, $0.0024/call, status unknown (last checked 2026-09-14).

Search and filter US federal awards (contracts, grants, loans, direct payments) from USAspending.gov, returning records sorted by dollar amount descending.

## Facts

- Endpoint: GET https://2s.io/api/gov/usaspending-awards
- Price: $0.0024/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-eb1d9c87
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_axOnrL2se_trtF5qGnofl

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 2s-io-eb1d9c87
```

Example prompt: Show me the largest Department of Defense contracts awarded to Lockheed Martin in Virginia between 2023-01-01 and 2024-12-31 — I want the top 25 results.

## When to prefer this

Use this endpoint when you need to search, filter, or analyze US federal government spending data across contracts, grants, loans, and direct payments. It is ideal for researching which companies or universities receive federal funding, tracking agency spending patterns, or looking up specific award details. Prefer this over general web search when you need structured, authoritative, public-domain federal spending data sorted by dollar amount.

## Known failure modes

- No records found for the given filters — returns empty results list
- Invalid date format (not YYYY-MM-DD) — schema validation error
- Invalid recipientState (not 2-letter code) — schema validation error
- Invalid awardType enum value — schema validation error
- Upstream USAspending.gov API unavailable — service error
- Page number exceeds maximum of 1000 — validation error
- Payment not processed — 402 payment required error

## How this service works

Search federal awards (contracts, grants, loans, direct payments) from USAspending.gov. Largest amount first within the date window. Each record includes award ID, recipient name, dollar amount, award type, awarding agency + sub-agency, start + end dates, description, and a permalink to the usaspending.gov detail page. Filter by recipient name, awarding agency name, recipient state, award type group, and date range. Backed by USAspending.gov's spending_by_award API; public-domain US government records.

## Output

A paginated list of federal award records sorted by dollar amount descending. Each record includes: award ID, recipient name, dollar amount, award type, awarding agency and sub-agency, start and end dates, description of the award, and a permalink to the USAspending.gov detail page.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "page": 1,
   "limit": 25,
   "agency": "Department of Defense",
   "awardType": "contracts",
   "recipientState": "VA"
  }
 }
}
```

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "page": {
       "type": "integer",
       "default": 1,
       "maximum": 1000,
       "minimum": 1,
       "description": "Page number (1-based). Default 1."
      },
      "limit": {
       "type": "integer",
       "default": 25,
       "maximum": 100,
       "minimum": 1,
       "description": "Records per page (1-100). Default 25."
      },
      "since": {
       "type": "string",
       "description": "Earliest action date (YYYY-MM-DD). Default = 5 years ago."
      },
      "until": {
       "type": "string",
       "description": "Latest action date (YYYY-MM-DD). Default = today."
      },
      "agency": {
       "type": "string",
       "maxLength": 120,
       "minLength": 2,
       "description": "Awarding top-tier agency name. Examples: \"Department of Defense\", \"National Institutes of Health\", \"Department of Energy\"."
      },
      "awardType": {
       "enum": [
        "contracts",
        "grants",
        "loans",
        "direct_payments",
        "other"
       ],
       "type": "string",
       "default": "contracts",
       "description": "Award type group. contracts = A/B/C/D; grants = 02/03/04/05; loans = 07/08; direct_payments = 06/10; other = 11. Default contracts."
      },
      "recipient": {
       "type": "string",
       "maxLength": 120,
       "minLength": 2,
       "description": "Recipient (vendor/grantee) name substring. Examples: \"Microsoft\", \"Lockheed Martin\", \"Stanford University\"."
      },
      "recipientState": {
       "type": "string",
       "maxLength": 2,
       "minLength": 2,
       "description": "2-letter US state of the recipient (e.g., \"CA\", \"VA\")."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-eb1d9c87/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)