# US Federal Awards USAspending

> US Federal Awards USAspending is a paid API for AI agents from api.boscolabs.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-13).

Retrieves US federal contracts, grants, and loans from USAspending.gov with winner details, amounts, NAICS/PSC codes, and place of performance

## Facts

- Endpoint: POST https://api.boscolabs.dev/v1/us-federal-awards?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-federal-awards-usaspending-60e276ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6nADFkxks_UQaa_6DItGA

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 us-federal-awards-usaspending-60e276ac -d '<json body>'
```

Example prompt: Can you find the top 10 federal contracts awarded to Lockheed Martin in 2024, sorted by amount, including NAICS codes and the awarding agency?

## When to prefer this

Use this endpoint when you need official, structured US federal award data (contracts, grants, loans) with per-award detail including recipient identity, dollar amounts, and industry codes. Prefer this over general web search when you need machine-readable, filterable government spending data tied to specific companies (by name, UEI, or stock ticker), agencies, NAICS/PSC codes, or date ranges. Especially valuable for competitive intelligence, compliance research, and investment analysis involving government revenue exposure.

## Known failure modes

- Empty result set when filters are too restrictive or no matching awards exist — no charge applied
- Error on invalid NAICS/PSC/CFDA code formats
- Date range parsing failure if format deviates from YYYY-MM-DD
- Ticker not matched to any known recipient — returns empty rather than error
- maxResults capped at 100; requests above this may be rejected
- Network or upstream USAspending.gov API unavailability

## How this service works

US federal contracts, grants and loans from USAspending.gov, every agency: winner, UEI, parent company, stock ticker, amounts, NAICS/PSC and place of performance. Typical call $0.005: $0.004 per award, min $0.005. upto: pay only for delivered rows; exact: pays the quote (default 10 rows; set maxResults). Nothing is settled on an error or empty result. By Bosco Labs: official sources, source link per row.

## Output

Returns a list of federal award rows (up to maxResults), each containing the award winner name, UEI, parent company, stock ticker if applicable, total obligated amount, NAICS and PSC codes, awarding agency, place of performance, action date, award type (contract/grant/loan), and a direct source link to USAspending.gov for each record.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "dateTo": {
   "type": "string",
   "pattern": "^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$",
   "description": "Latest action date, YYYY-MM-DD, e.g. \"2026-09-30\""
  },
  "sortBy": {
   "enum": [
    "amount",
    "date"
   ],
   "type": "string",
   "default": "amount",
   "description": "\"amount\" (default) = awards ordered by their largest action"
  },
  "tickers": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^\\s*[A-Za-z0-9][A-Za-z0-9./-]{0,9}\\s*$"
   },
   "description": "Only awards whose recipient or its parent company matches these US-listed tickers"
  },
  "agencies": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^[^\\[\\]{}<>\\r\\n]*$"
   },
   "description": "Awarding agencies by abbreviation, name or toptier code"
  },
  "dateFrom": {
   "type": "string",
   "pattern": "^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$",
   "description": "Earliest action date (signing date of the award or of a modification), YYYY-MM-DD, e.g. \"2026-07-01\""
  },
  "keywords": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^[^\\[\\]{}<>\\r\\n]*$"
   },
   "description": "Full-text search over award descriptions and other text fields"
  },
  "pscCodes": {
   "type": "array",
   "description": "Product and Service Codes, e.g. [\"DA01\"] (IT software development) or [\"AR\"] (space R&D)"
  },
  "minAmount": {
   "type": "integer",
   "maximum": 1000000000000,
   "minimum": 0,
   "description": "Only awards whose total obligated amount"
  },
  "awardTypes": {
   "type": "array",
   "items": {
    "enum": [
     "contracts",
     "grants",
     "loans",
     "direct_payments",
     "other"
    ],
    "type": "string"
   },
   "default": [
    "contracts"
   ],
   "description": "Which awards: \"contracts\""
  },
  "maxResults": {
   "type": "integer",
   "default": 10,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum award rows, one per award, e.g. 20"
  },
  "naicsCodes": {
   "type": "array",
   "description": "NAICS industry codes, 2 to 6 digits, e.g. [\"541512\"] (computer systems design) or [\"3364\"]"
  },
  "recipients": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^[^\\[\\]{}<>\\r\\n]*$"
   },
   "description": "Winning organisations, as name text or 12-character SAM UEI"
  },
  "cfdaNumbers": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^\\s*\\d{2}\\.\\d{3}\\s*$"
   },
   "description": "As
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-federal-awards-usaspending-60e276ac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.boscolabs.dev](https://www.zero.xyz/host/api.boscolabs.dev/llms.txt)
