Federal Awards API: USAspending contracts, grants and loans as clean JSON
Federal contracts, IDVs, grants and loans since FY2008 from USAspending.gov, with cleaner fields, recipient profiles, spending totals and listed-company tags.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/usaspending/awards?naics=336411&startDate=2026-01-01&size=2"
import os, requests
r = requests.get(
"https://secfeedapi.com/v1/usaspending/awards",
params={'naics': '336411', 'startDate': '2026-01-01', 'size': '2'},
headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
)
print(r.json()){
"awards": [
{
"awardId": "N0001917C0001",
"id": "CONT_AWD_N0001917C0001_9700_-NONE-_-NONE-",
"type": "contracts",
"awardType": "DEFINITIVE CONTRACT",
"recipientName": "LOCKHEED MARTIN CORPORATION",
"recipientUei": "G4KDGE4JFFK7",
"recipientId": "6cf5fb1b-4988-d087-5dc1-70939d8fc6c4-C",
"amount": 35135514910.2,
"outlays": 933036846.29,
"subsidyCost": null,
"awardingAgency": "Department of Defense",
"awardingSubAgency": "Department of the Navy",
"startDate": "2017-11-17",
"endDate": "2031-03-31",
"naics": {
"code": "336411",
"description": "AIRCRAFT MANUFACTURING"
},
"psc": {
"code": "1510",
"description": "AIRCRAFT, FIXED WING"
},
"cfdaNumber": null,
"placeOfPerformanceState": "TX",
"description": "LRIP LOT 12 ADVANCE ACQUISITION CONTRACT",
"secCompany": {
"cik": 936468,
"ticker": "LMT",
"name": "LOCKHEED MARTIN CORP"
}
},
{
"awardId": "FA862511C6600",
"id": "CONT_AWD_FA862511C6600_9700_-NONE-_-NONE-",
"type": "contracts",
"awardType": "DEFINITIVE CONTRACT",
"recipientName": "THE BOEING COMPANY",
"recipientUei": "WZWRLY4G3PL8",
"recipientId": "22d282c6-4508-7d30-97f1-7401ea73b12a-C",
"amount": 31972918249.03,
"outlays": 271607247.33,
"subsidyCost": null,
"awardingAgency": "Department of Defense",
"awardingSubAgency": "Department of the Air Force",
"startDate": "2011-02-24",
"endDate": "2027-07-31",
"naics": {
"code": "336411",
"description": "AIRCRAFT MANUFACTURING"
},
"psc": {
"code": "1510",
"description": "AIRCRAFT, FIXED WING"
},
"cfdaNumber": null,
"placeOfPerformanceState": "WA",
"description": "KC-X MODERNIZATION PROGRAM",
"secCompany": {
"cik": 12927,
"ticker": "BA",
"name": "BOEING CO"
}
}
],
"hasNext": true,
"from": 0,
"size": 2,
...Overview
USAspending.gov records every federal award: who received it, which agency paid, how much, for what and where. Its API is open but verbose, with field names that change by award type and a recipient search that returns names without ids.
The Federal Awards API returns one consistent shape for contracts, IDVs, grants and loans, adds recipient search with ids and UEIs, spending totals by agency, recipient, NAICS or state, and tags each award with the listed company behind the recipient when there is one, so you can go from an award to a ticker.
What you get
Built for developers who would rather not parse EDGAR.
Contracts, IDVs, grants, loans, direct payments and other assistance since FY2008.
Find a company by name and get its id, UEI and whether it is a parent or a subsidiary.
Group spending by agency, sub-agency, recipient, NAICS, PSC, CFDA program, state or country.
secCompany on each award names the CIK and ticker when the recipient or its parent is listed.
Endpoints
Authenticate with Authorization: Bearer YOUR_KEY. Responses are JSON.
Federal awards from USAspending.gov since FY2008: contracts, IDVs, grants, loans and more, each tagged with the listed company it belongs to.
Parameters: type (contracts, idvs, grants, loans, direct, other), q, recipient, uei, naics, psc, agency, state, setAside, startDate, endDate, sort (amount, startDate, endDate), order, from, size (max 100)
One federal award: amounts, period, agencies, recipient and parent, competition, set-aside, subawards.
Parameters: id (the id field of an award)
Find federal award recipients by name, with ids, UEIs and parent or child level.
Parameters: q, from, size (max 50)
A recipient profile: parent, business types, location and the last 12 months of awards.
Parameters: id
Federal spending totals grouped by agency, recipient, NAICS, PSC, CFDA program, state or country.
Parameters: by, and the same filters as /v1/usaspending/awards
Response fields
The main fields in every result. The raw filing data is always one level down.
| Field | Meaning |
|---|---|
awards[].awardId, id, type, awardType | Award number, the id for detail calls and the award type. |
awards[].recipientName, recipientUei, recipientId | Who received the award. |
awards[].amount, outlays | Obligated amount and money paid out so far. |
awards[].awardingAgency, awardingSubAgency | The agency that made the award. |
awards[].naics, psc, startDate, endDate | What was bought and the period of performance. |
awards[].secCompany | CIK, ticker and name of the listed company behind the recipient, or null. |
Use cases
- Competitor research for government contractors
- Tracking agency spending by industry
- Due diligence on a company's federal revenue
- Grant and loan research by program and state
Guides
FAQ
Where does the data come from?
USAspending.gov, the official source for federal spending. SecFeed queries it live and caches answers for up to a day.
How far back does it go?
Award searches cover fiscal year 2008 onward, which is where USAspending's search history starts.
Why is there no total count?
USAspending pages results without a total. Responses say hasNext instead, and you page with from and size.
Try the Federal Awards API free
Free key, no card, no sales call.