# US Federal Contract and Grant Awards Search (USAspending.gov)

> US Federal Contract and Grant Awards Search (USAspending.gov) is a paid API for AI agents from usaspending-awards-production.up.railway.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Search and retrieve US federal contract, grant, IDV, and loan award records from USAspending.gov by keyword, recipient, agency, NAICS code, or date range.

## Facts

- Endpoint: GET https://usaspending-awards-production.up.railway.app/v1/us-awards/search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-federal-contract-and-grant-awards-search-usaspending-gov-f312eea3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_T5c2cLXOYKX1SeZRMXmod

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-contract-and-grant-awards-search-usaspending-gov-f312eea3
```

Example prompt: Search USAspending.gov for federal contracts awarded to Palantir Technologies in the last 730 days — I want to see the award amounts, agencies, and descriptions, up to 25 results.

## When to prefer this

Use this endpoint when you need authoritative, official US federal spending data directly sourced from USAspending.gov (Treasury). It is ideal for competitive intelligence on who wins government contracts, prospecting for sales leads among federal contractors, researching grant recipients by keyword or agency, or auditing a specific company's federal award history. Prefer this over general web search when you need structured, filterable award data with UEIs, amounts, and agency breakdowns.

## Known failure modes

- No awards found matching filters — returns empty awards array with status ok
- Invalid award_type value — may return error or empty results
- NAICS code not recognized — returns empty results
- days parameter exceeds 3650 maximum — may be clamped or return error
- limit outside 1-50 range — may be rejected or clamped
- USAspending.gov upstream API timeout or unavailability — returns error status

## How this service works

Search US federal awards from USAspending.gov (official Treasury data): contracts, IDVs, grants or loans by keyword, recipient name, awarding agency, NAICS and date range. Returns award ID, recipient, UEI, amount, agency, sub-agency, dates, description, place of performance and links. Use when you need to know who wins US federal contracts or grants (competitors, partners, sales leads) or what a given company has been awarded, by keyword, recipient, agency, NAICS or date.

## Output

Returns a JSON object containing an array of award records, each with award ID, recipient name, recipient UEI, dollar amount, awarding agency and sub-agency, start and end dates, award description, place of performance (state and country), and a direct link to the USAspending.gov award detail page. Also includes total count returned and API status.

## 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",
     "properties": {
      "days": {
       "type": "integer",
       "description": "Look-back days by action date (default 365, max 3650)"
      },
      "limit": {
       "type": "integer",
       "description": "Max awards 1-50 (default 20)"
      },
      "naics": {
       "type": "string",
       "description": "Comma-separated NAICS codes (2-6 digits)"
      },
      "query": {
       "type": "string",
       "description": "Keywords in award description"
      },
      "agency": {
       "type": "string",
       "description": "Awarding top-tier agency name, e.g. 'Department of Defense'"
      },
      "recipient": {
       "type": "string",
       "description": "Recipient (company) name contains"
      },
      "award_type": {
       "type": "string",
       "description": "contracts (default), idvs, grants or loans"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "legal": {
   "terms": "https://usaspending-awards-production.up.railway.app/terms",
   "privacy": "https://usaspending-awards-production.up.railway.app/privacy"
  },
  "awards": [
   {
    "url": "https://www.usaspending.gov/award/CONT_AWD_...",
    "amount": 52405513,
    "award_id": "HQ085722F8003",
    "end_date": "2027-02-28",
    "recipient": "AMENTUM TECHNOLOGY, INC.",
    "start_date": "2022-03-01",
    "description": "...",
    "recipient_uei": "...",
    "awarding_agency": "Department of Defense",
    "awarding_sub_agency": "Missile Defense Agency",
    "place_of_performance": {
     "state": "AL",
     "country": "USA"
    }
   }
  ],
  "status": "ok",
  "returned": 1,
  "use_when": "Use when you need to know who wins US federal contracts or grants (competitors, partners, sales leads) or what a given company has been awarded, by keyword, recipient, agency, NAICS or date."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-federal-contract-and-grant-awards-search-usaspending-gov-f312eea3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from usaspending-awards-production.up.railway.app](https://www.zero.xyz/host/usaspending-awards-production.up.railway.app/llms.txt)