What you can ask
- “What does USA Spending have for the area or asset I'm working on?”
- “Pull the most recent USA Spending records and put them in a table.”
- “What does USA Spending cover, and how fresh is the data?”
About this source
Federal spending transparency — every prime award since FY2008 (Treasury/OMB). No auth. - searchAwards ⭐ filter recipient, NAICS, agency, place - getAwardById ⭐ full record by generated_internal_id - searchByRecipient ⭐ recipient-name fuzzy wrapper - searchByNaics ⭐ NAICS (oil-svcs 21 / 2111 / 213111) - searchByAgency by toptier_code (089 DOE, 097 DoD) - getRecipientById profile (-C/-P/-R suffix) - autocompleteRecipient fuzzy name -> hits - getServiceInfo taxonomy + agencies + NAICS upstream quirk: award_type_codes MUST be a single group per call (mixed groups → 422). Pass awardTypeGroup (contracts | idvs | grants | loans | direct_payments | other_financial_assistance); handler rejects mixed groups. upstream quirk: limit caps at 100; page 1-indexed; time_period floor 2007-10-01.
Connector ID usaspending
Provenance
Freshness & coverage
› Methods (8)
Technical detail for developers: parameters, pagination, units, and freshness per method.
searchAwards
readFederal awards search. Filter timePeriod, awardTypeGroup, recipient, NAICS, agency, place.
awardTypeGroup must be a single group; mixed groups return 422.
getAwardById
readFull award record by generated_internal_id (agency, period of performance, exec comp).
Pass generated_internal_id verbatim from a searchAwards result.
searchByRecipient
readRecipient-name fuzzy convenience wrapper (uses recipient_search_text under the hood).
Defaults to contracts + the past 5 years (to today) if timePeriod omitted.
searchByNaics
readNAICS slicing wrapper. Oil-services use 21 / 2111 / 2131 / 213111 / 213112.
Accepts 2- to 6-digit prefixes; pass highest specificity available.
searchByAgency
readAwards filtered by awarding agency toptier_code (089 DOE, 097 DoD, 014 Interior).
getRecipientById
readRecipient profile by hash. -C (child) / -P (parent) / -R (standalone) suffix.
Pass hash verbatim; bare hash (no suffix) is rejected upstream.
autocompleteRecipient
unknownFuzzy name -> recipient hit list (use to discover recipient hashes).
getServiceInfo
readAward type taxonomy, agency (toptier_code) reference, NAICS reference, pagination caps.
