buriedsignals/anomaly/usaspending-awards

Query USAspending federal awards

meta.yaml is the executable contract. Use only released operations.

<!-- BEGIN GENERATED OPERATION STATUS -->

Current catalogue release status

meta.yaml is authoritative. Execute only operations listed as Released below; other sections in this playbook may document provider or unreleased adapter scope.

Released

• us/usaspending/awards:search-awards — Search one award-type group over an explicit date range or federal fiscal year with bounded, type-compatible fields and pagination.

<!-- END GENERATED OPERATION STATUS -->

Define type and time explicitly

catalogue query us/usaspending/awards --operation search-awards \
  --input '{"recipient":"Boeing","award_type":"contracts","fiscal_year":2025,"limit":10}'

A federal fiscal year runs October 1 through September 30. Supplying explicit dates requires both start_date and end_date. If neither is present, the adapter uses the current federal fiscal year and returns that window in query_window.

Use recipient to search recipient name, UEI, and DUNS. Use keyword for the broader award keyword filter. award_id is quoted upstream for exact matching.

Interpret amounts and records

• amount is Award Amount, except loans where it is Loan Value.
• total_outlays and subsidy_cost are separate fields when valid for the type.
• This operation returns prime awards, not transactions or subawards.
• A recipient-name match is not entity resolution; verify UEI, generated award

ID, agency, dates, and the linked award profile.

• Corrections and modifications can change award-level values over time.

Fill the procurement contract

procurement-processes and procurement-awards run the contract search, then read each award's detail (/api/v2/awards/{generated_unique_award_id}/, one extra request per record) and return rows of the procurement domain contract (domains/procurement.yaml). Write each to CSV and run the procurement detectors with python -m anomaly.oneshot --tables procurement_processes=... --tables procurement_awards=....

catalogue query us/usaspending/awards --operation procurement-processes \
  --input '{"keyword":"software","fiscal_year":2025,"limit":50}'

The extent-competed mapping follows the FPDS code definitions in the USAspending data dictionary and the OCDS method codelist; F (simplified acquisition, competed) is limited because the buyer chooses whom to ask.

final_value stays empty: the API reports only current values, not the value at award, and cumulative obligations grow with incremental funding of an unchanged contract (a live sample on 2026-10-27 flagged 47 of 50 contracts that way). For value_growth_after_award, take the bulk award download (Contracts_PrimeTransactions) and map the first action's base_and_exercised_options_value to award_value and the latest base_and_exercised_options_value to final_value.

Read the API reference for filters, type codes, type-specific fields, pagination, and amount semantics. Read the query guide for reproducible award research.

Bundled resources

• references/api-reference.md — Firecrawl-preserved Treasury API contract and endpoint index.
• references/query-guide.md — time/type selection, recipient resolution, and reporting.
• scripts/verify.py and assets/verification-cases.json — live contract and grant checks.
• evals/evals.json — amount, recipient, time-window, and subaward cases.

python3 scripts/verify.py --list
python3 scripts/verify.py