searchAwards

Free

Search US federal awards (contracts, grants, loans...) by keyword, recipient name or UEI, NAICS code, awarding agency and action date. Returns award amount, dates, agency, NAICS/PSC and recipient for each. Use it to list a company's federal contracts, screen awards in an industry, or find what changed recently (sortBy lastModified). Use getAwardDetails with an awardId for competition and parent contract data.

Try it

Open in playground

kirha tools run usaspending_searchAwards \
  --input '{}'

Uses the key saved by kirha auth login.

agencystring
Awarding toptier agency name or abbreviation, e.g., DOD, NASA, HHS
awardCategorystring, default "contracts"
One of contracts, idvs, grants, directPayments, loans, other
endDatestring, YYYY-MM-DD
YYYY-MM-DD
keywordsstring
Free text over award descriptions, e.g., 'large language model'
limitinteger, default 10, 1 to 50
naicsCodesstring[], Up to 10 items
e.g., 541511, or a prefix like 5415
pageinteger, default 1, 1 to 100
recipientstring
Recipient name, or its UEI for an exact match that also covers its subsidiaries
sortBystring, default "amount"
One of amount, startDate, lastModified
startDatestring, YYYY-MM-DD
YYYY-MM-DD, earliest action date (2007-10-01 at the earliest)

Works in any harness

Get your API key, then install with one command