Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaLead GenAvailable now

USAspending · Award search

usaspending-gov/awards/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.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
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

FieldKindDefaultDescription
award_type_codes requiredlist—

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.

sortone 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.

cursortext—

next_cursor from the previous page; bound to identical filters, sort and page_size. Depth is capped at 500 pages.

agenciesJSON—

agencies

keywordslist—

Free-text terms matched against award descriptions, recipient names and ids (OR).

page_sizenumber
1 to 100
20

page_size

psc_codeslist—

Contracts/IDVs only.

naics_codeslist—

Contracts/IDVs only; 2, 4 or 6 digit NAICS codes (sector, industry group or national industry). USAspending rejects other lengths.

time_periodJSON—

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_amountsJSON—

USD ranges (OR) on the award total; at least one bound each.

place_of_performanceJSON—

place_of_performance

recipient_search_texttext—

Recipient name, UEI or DUNS text.

Same request in code

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>"
      ]
    }
  }'

Frequently asked questions

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.