# USAspending · Award search

Find companies, people and contact details with USAspending · Award search from Alexandria through one Spiral API key. Search USAspending prime awards by keyword, awarding/funding agency, recipient name or UEI, action-date window, place of performance, NAICS, PSC and award amount within one award family (contracts, IDVs, grants, loans, direct payments or other). It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Lead Gen
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `usaspending-gov/awards/award_search`
- Page: https://spiral.ai/tools/alexandria/usaspending-gov/awards/award_search

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `award_type_codes` (required) | list |  | — | Required. One family only: contracts A (BPA call), B (purchase order), C (delivery order), D (definitive contract); IDVs IDV_A..IDV_E; grants 02 block, 03 formula, 04 project, 05 cooperative agreement; direct payments 06, 10; loans 07 direct, 08 guaranteed; other 09 insurance, 11 other, -1. |
| `sort` | one of | amount_desc, amount_asc, start_date_desc, start_date_asc, end_date_desc, end_date_asc, last_modified_desc, last_modified_asc, recipient_name_asc, recipient_name_desc, award_id_asc, award_id_desc | amount_desc | Result order. For loans amount_* sorts by Loan Value and start_date_* by Issued Date; end_date_* is rejected for loans. |
| `cursor` | text |  | — | next_cursor from the previous page; bound to identical filters, sort and page_size. Depth is capped at 500 pages. |
| `agencies` | JSON |  | — | agencies |
| `keywords` | list |  | — | Free-text terms matched against award descriptions, recipient names and ids (OR). |
| `page_size` | number | 1 to 100 | 20 | page_size |
| `psc_codes` | list |  | — | Contracts/IDVs only. |
| `naics_codes` | list |  | — | Contracts/IDVs only; 2, 4 or 6 digit NAICS codes (sector, industry group or national industry). USAspending rejects other lengths. |
| `time_period` | JSON |  | — | Action-date windows (OR). start_date >= 2007-10-01. Omitted = 2007-10-01 to 2030-09-30. FY2025 is 2024-10-01..2025-09-30. |
| `award_amounts` | JSON |  | — | USD ranges (OR) on the award total; at least one bound each. |
| `place_of_performance` | JSON |  | — | place_of_performance |
| `recipient_search_text` | text |  | — | Recipient name, UEI or DUNS text. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "usaspending-gov/awards/award_search",
    "input": {
      "award_type_codes": [
        "<award_type_codes>"
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=usaspending-gov%2Fawards%2Faward_search

## Common questions

### USAspending · Award search

**How much does USAspending · Award search cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use USAspending · Award search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "usaspending-gov/awards/award_search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use USAspending · Award search?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use USAspending · Award search?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

