USAspending Federal Awards - Contracts, Grants, Loans

Get U.S. federal spending awards — who received the money, from which agency, how much, for what and where — from the official public USAspending.gov API. One row per award: contracts, contract vehicles (IDVs), grants, direct payments, loans and other financial assistance.

• No API key, no login. Only the documented public API at api.usaspending.gov is used.
• Several award types in one run, merged into one ordered list (largest first, newest first or most recently modified first).
• Nothing silently cut off. Large result sets are paged with USAspending's own sequential cursor (plain page numbers stop being exact after 10,000 results), and every run reports how many awards matched in total.
• Agency names the way people write them: "DoD", "Defense", "VA", "HHS", "NASA", or sub-agencies such as "National Institutes of Health" or "Department of the Army".
• Flat, analysis-ready columns: recipient and UEI, awarding and funding agency and sub-agency with codes, obligated and outlayed amounts (face value and subsidy cost for loans), dates, NAICS and PSC with descriptions, Assistance Listing (CFDA) number and title, place of performance down to state, county (with FIPS) and city, and links to the award and recipient pages on USAspending.gov.
• Companies and organisations only. People and sole proprietors are never named (see below).

The natural companion of a SAM.gov opportunities feed: SAM.gov tells you what the government plans to buy; USAspending tells you who won and what was actually obligated and paid.

Quick start — verified input

{
  "awardTypes": ["contracts", "grants"],
  "agencies": ["NASA"],
  "daysBack": 30,
  "maxItems": 20
}

This returns NASA's 20 largest contracts and grants with activity in the last 30 days, in under a minute. An empty input ({}) returns the 100 largest contracts and grants of all agencies with activity in the last 30 days.

More examples:

{ "awardTypes": ["contracts"], "naicsCodes": ["541512"], "states": ["VA", "MD"], "dateType": "new", "sortBy": "newest", "daysBack": 60, "maxItems": 500 }

{ "awardTypes": ["grants"], "agencies": ["National Institutes of Health"], "dateFrom": "FY2025", "dateTo": "FY2025", "minAmount": 1000000 }

{ "awardTypes": ["contracts", "idvs"], "recipientName": "Booz Allen Hamilton", "dateFrom": "2024-10-01", "maxItems": 1000 }

Input

Field	What it does
awardTypes	contracts, idvs, grants, direct_payments, loans, other, assistance (all four assistance types) or all. Single codes work too: A BPA call, B purchase order, C delivery order, D definitive contract, 02–05 grants, 06/10 direct payments, 07/08 loans, 09/11 other. Default: contracts and grants.
keywords	Words USAspending searches across the award (description, award ID, recipient, programme). Any of them matches. At least 3 characters each.
recipientName	Part of a company or organisation name, or its UEI.
agencies, agencyRole	Agencies or sub-agencies (names or abbreviations); awarding (signed the award, default) or funding (whose money it is).
states	Place-of-performance states or territories (codes or names).
naicsCodes	2–6 digit NAICS codes or prefixes (contracts and IDVs).
pscCodes	4-character Product and Service Codes (contracts and IDVs).
assistanceListings	Assistance Listing (CFDA) numbers, e.g. 93.778.
awardIds	Contract numbers (PIID), grant numbers (FAIN) or URIs, matched by USAspending's award ID search.
minAmount, maxAmount	Award amount range in dollars.
daysBack, dateFrom, dateTo	The window. Dates as YYYY-MM-DD, MM/DD/YYYY, today, or fiscal years (FY2025). Earliest: 2007-10-01.
dateType	active (any activity in the window — USAspending's default), new (first signed in the window) or modified.
sortBy	amount (largest first), newest (base obligation date) or lastModified.
maxItems	Rows to return (1–100,000).
verifyRecipients, maxRecipientLookups	Business-type check for unclear recipient names (one request per recipient, cached).
maxApiRequests	Hard request budget; 0 = automatic.

Output example

{
  "awardId": "NAS1510000",
  "awardKey": "CONT_AWD_NAS1510000_8000_-NONE-_-NONE-",
  "awardCategory": "contract",
  "awardType": "DEFINITIVE CONTRACT",
  "recipientName": "THE BOEING COMPANY",
  "recipientUei": "HLWWEH2CCXW5",
  "recipientId": "690fafd3-ecd8-1228-92a0-07aa28dd1ee2-C",
  "recipientWithheld": false,
  "recipientWithheldReason": null,
  "recipientNameBasis": "business_type",
  "awardingAgency": "National Aeronautics and Space Administration",
  "awardingAgencyCode": "080",
  "awardingSubAgency": "National Aeronautics and Space Administration",
  "awardingSubAgencyCode": "8000",
  "fundingAgency": "National Aeronautics and Space Administration",
  "fundingAgencyCode": "080",
  "fundingSubAgency": "National Aeronautics and Space Administration",
  "fundingSubAgencyCode": "8000",
  "obligatedAmount": 22653589199.84,
  "outlayedAmount": 2714678720.61,
  "loanFaceValue": null,
  "loanSubsidyCost": null,
  "startDate": "1993-11-15",
  "endDate": "2031-09-30",
  "baseObligationDate": "1993-11-15",
  "lastModifiedDate": "2026-10-05",
  "lastDateToOrder": null,
  "loanIssuedDate": null,
  "naicsCode": "336414",
  "naicsDescription": "GUIDED MISSILE AND SPACE VEHICLE MANUFACTURING",
  "pscCode": "AR62",
  "pscDescription": "R&D- SPACE: STATION (APPLIED RESEARCH/EXPLORATORY DEVELOPMENT)",
  "assistanceListingNumber": null,
  "assistanceListingTitle": null,
  "assistanceListings": [],
  "placeOfPerformanceCountryCode": "USA",
  "placeOfPerformanceCountry": "UNITED STATES",
  "placeOfPerformanceState": "TX",
  "placeOfPerformanceStateName": "Texas",
  "placeOfPerformanceCounty": "HARRIS",
  "placeOfPerformanceCountyFips": "48201",
  "placeOfPerformanceCity": "HOUSTON",
  "placeOfPerformanceCongressionalDistrict": "36",
  "description": "INTERNATIONAL SPACE STATION",
  "usaspendingUrl": "https://www.usaspending.gov/award/CONT_AWD_NAS1510000_8000_-NONE-_-NONE-",
  "recipientProfileUrl": "https://www.usaspending.gov/recipient/690fafd3-ecd8-1228-92a0-07aa28dd1ee2-C/latest",
  "source": "USAspending.gov (U.S. Department of the Treasury, Bureau of the Fiscal Service) - official public API",
  "sourceUrl": "https://www.usaspending.gov",
  "license": "Source: USAspending.gov, U.S. Department of the Treasury, Bureau of the Fiscal Service, https://www.usaspending.gov. ...",
  "retrievedAt": "2026-10-12T22:25:37.661Z"
}

Amounts are U.S. dollars as published (obligatedAmount is the award's total obligation and can be negative after de-obligations; loans carry loanFaceValue and loanSubsidyCost instead). A run summary (RUN_SUMMARY in the key-value store) lists, per award type, how many awards matched, how many were read, and why a run stopped early if it did.

Recipients: companies and organisations only

USAspending itself redacts individuals who receive financial assistance ("REDACTED DUE TO PII") and publishes some programmes as county-level aggregates ("MULTIPLE RECIPIENTS"). Contracts and loans can still go to sole proprietors under their personal names. This Actor names a recipient only when it is clearly an organisation:

• a legal form in the name (LLC, Inc., Corp., Ltd., L.P., P.C., P.A., N.A., GmbH, S.A. ...), or an unmistakable public body or institution (University, County, City of, Department, Tribe, School District, Authority, Credit Union ...), or
• for unclear names ("THE BOEING COMPANY", "XYZ CONTRACTING"), the recipient's business type on USAspending: corporations, LLCs, non-profits, universities and governments are named; sole proprietorships and individuals are not.

When a recipient is not named, recipientName, recipientUei, recipientId, recipientProfileUrl and description are null, recipientWithheld is true and recipientWithheldReason says why: redacted_by_source, aggregate_record, individual_or_sole_proprietor, not_verified_as_organization or dnb_open_data. The award facts (agency, amount, dates, codes, place) stay. With a keyword or recipient search, awards whose recipient may be a person are left out entirely, because the search text could be that person's name; the run summary counts them (excludedForPrivacy).

Recipient names of awards last modified before 2022-04-04 are withheld (dnb_open_data): records from before the federal switch from DUNS to UEI may contain Dun & Bradstreet data, which USAspending's licence restricts. DUNS numbers and recipient addresses are never collected.

Empty results?

• DoD and Army Corps of Engineers contracts appear with a 90-day delay on USAspending; use a longer window (daysBack: 180).
• Grants and other assistance are reported by agencies in batches, often weeks after the action date: a 7-day window can be empty for an agency that has thousands of awards over 90 days.
• NAICS and PSC codes exist only on contracts and IDVs; Assistance Listings only on grants, loans, direct payments and other assistance.
• A short window plus several filters can simply match nothing — widen daysBack or drop a filter.
• Under a keyword search, awards to individuals are left out (see above), so a keyword that only appears in such awards returns 0 rows.
• An agency name USAspending does not know stops the run with the closest matching names — copy one of them.

Common input mistakes

Wrong	Right
"awardTypes": ["subawards"]	Subawards are not included; use contracts, idvs, grants, direct_payments, loans, other
"states": ["Los Angeles"]	"states": ["CA"] (states or territories only)
"naicsCodes": ["5415121"]	"naicsCodes": ["541512"] (2–6 digits)
"keywords": ["AI"]	"keywords": ["artificial intelligence"] (3+ characters)
"assistanceListings": ["93778"]	"assistanceListings": ["93.778"]
"dateFrom": "2005-01-01"	USAspending search starts at 2007-10-01 (FY2008)

Speed and limits

Requests are made one at a time, at least 1.5 seconds apart, 100 awards per page, plus one business-type lookup per unclear recipient. Roughly: 100 rows ≈ 10–30 seconds, 10,000 rows ≈ 5 minutes. USAspending publishes no rate limit; the Actor honours Retry-After, backs off on errors and stops cleanly (keeping the rows it has, complete: false with a reason) if the API stops answering. No proxy is needed.

Data source, licence and disclaimer

• Source: USAspending.gov, U.S. Department of the Treasury, Bureau of the Fiscal Service, https://www.usaspending.gov (the citation USAspending suggests). Every row carries this attribution in source, sourceUrl, license and retrievedAt.
• USAspending.gov states that its data "is available to copy, adapt, redistribute, or otherwise use for non-commercial or for commercial purposes, subject to the Limitation on Permissible Use of Dun & Bradstreet, Inc. Data" (https://www.usaspending.gov/db_info). Any D&B Open Data that may remain in older records is attributed to Dun & Bradstreet, Inc.; do not use it in bulk.
• Unofficial. This Actor is not affiliated with, endorsed by or sponsored by the U.S. Department of the Treasury, the Bureau of the Fiscal Service or any U.S. Government agency. Data is provided as published by USAspending.gov, without warranty; for contract data FPDS is the authoritative source.
• Only publicly available data is collected, through the official public API. You are responsible for using the data lawfully and in line with USAspending.gov's terms, including the D&B limitation.
• Personal data: the Actor is built not to output personal data (no names of individuals or sole proprietors, no addresses, no contact details). If you combine the output with other data, GDPR and similar laws may still apply to you.