Federal Awards API reference | SecFeed for developers

Endpoints

/v1/usaspending/awards

GEThttps://secfeedapi.com/v1/usaspending/awards

Federal awards from USAspending.gov since FY2008: contracts, IDVs, grants, loans and more, each tagged with the listed company it belongs to.

Parameter	Type	Description	Example
`type`	string	contracts, idvs, grants, loans, direct or other. Default `contracts`.	`contracts`
`q`	string	Keywords.	`cloud`
`recipient`	string	Recipient name.	`Booz Allen`
`uei`	string	Recipient UEI; a parent UEI covers its subsidiaries.	`ZFN2JJXBLZT3`
`naics`	string	Comma separated NAICS codes.	`541512`
`psc`	string	Comma separated product or service codes.	`DA01`
`agency`	string	Awarding agency, exact top-tier name.	`Department of Defense`
`state`	string	Place of performance state codes.	`VA`
`setAside`	string	Set-aside codes.	`SBA`
`startDate`	string	YYYY-MM-DD, not before 2007-10-01. Default `2007-10-01`.	`2026-01-01`
`endDate`	string	YYYY-MM-DD. Default `today`.
`sort`	string	amount, startDate or endDate. Default `amount`.
`order`	string	asc or desc. Default `desc`.
`from`	integer	Offset, a multiple of size. Default `0`.
`size`	integer	1 to 100. Default `20`.

Responses have hasNext instead of a total count.
Answers are cached for 6 hours.

/v1/usaspending/award

GEThttps://secfeedapi.com/v1/usaspending/award

One federal award: amounts, period, agencies, recipient and parent, competition, set-aside, subawards.

Parameter	Type	Description	Example
`id`required	string	The id field of an award row.	`CONT_AWD_36C10B21N10150056_3600_VA11816D1015_3600`

Cached for 24 hours.

/v1/usaspending/recipients

GEThttps://secfeedapi.com/v1/usaspending/recipients

Find federal award recipients by name, with ids, UEIs and parent or child level.

Parameter	Type	Description	Example
`q`required	string	Name, 3 or more characters.	`lockheed martin`
`from`	integer	Offset. Default `0`.
`size`	integer	1 to 50. Default `10`.

level is P for a parent, C for a child, R for a recipient with no parent.

/v1/usaspending/recipient

GEThttps://secfeedapi.com/v1/usaspending/recipient

A recipient profile: parent, business types, location and the last 12 months of awards.

Parameter	Type	Description	Example
`id`required	string	Recipient id from a search.	`30b32b62-ffbf-d7e6-5b9d-95a295b95a6d-C`

/v1/usaspending/spending

GEThttps://secfeedapi.com/v1/usaspending/spending

Federal spending totals grouped by agency, recipient, NAICS, PSC, CFDA program, state or country.

Parameter	Type	Description	Example
`by`required	string	awarding_agency, awarding_subagency, recipient, naics, psc, cfda, state_territory or country.	`recipient`
`size`	integer	1 to 100. Default `20`.

Takes the same filters as /v1/usaspending/awards.

Request examples

Every response below is real output from the API, trimmed to the first records.

Largest aircraft manufacturing awards this year

Contracts sorted by amount; note secCompany on rows from listed companies.

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']}"},
    timeout=60,
)
r.raise_for_status()
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",
  ...

Top recipients in computer systems design

Spending totals grouped by recipient for one NAICS code.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/usaspending/spending?by=recipient&naics=541512&startDate=2026-01-01&size=3"

import os, requests

r = requests.get(
    "https://secfeedapi.com/v1/usaspending/spending",
    params={'by': 'recipient', 'naics': '541512', 'startDate': '2026-01-01', 'size': '3'},
    headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
    timeout=60,
)
r.raise_for_status()
print(r.json())

{
  "by": "recipient",
  "results": [
    {
      "name": "ACCENTURE FEDERAL SERVICES LLC",
      "code": "139727148",
      "id": "d41a6b8a-9d6a-0d28-7e24-989e31731aad-C",
      "amount": 2813575180.3
    },
    {
      "name": "ORACLE HEALTH GOVERNMENT SERVICES, INC.",
      "code": "080898173",
      "id": "9232b26d-789d-bdd2-5a6d-28714f1dfa2c-C",
      "amount": 2026079210.87
    }
  ],
  "source": "USAspending.gov"
}

One award in full

Amounts, period, agencies, recipient and parent, competition and the IDV it was ordered under.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/usaspending/award?id=CONT_AWD_36C10B21N10150056_3600_VA11816D1015_3600"

import os, requests

r = requests.get(
    "https://secfeedapi.com/v1/usaspending/award",
    params={'id': 'CONT_AWD_36C10B21N10150056_3600_VA11816D1015_3600'},
    headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
    timeout=60,
)
r.raise_for_status()
print(r.json())

{
  "id": "CONT_AWD_36C10B21N10150056_3600_VA11816D1015_3600",
  "awardId": "36C10B21N10150056",
  "category": "contract",
  "awardType": "DELIVERY ORDER",
  "description": "PRODUCT AND TECHNOLOGY ECOSYSTEM MANAGEMENT SERVICES (PTEMS)WHICH INCLUDES PRODUCT DELIVERY AND LIFECYCLE MANAGEMENT TO TRANSFORM VA BY TAPPING INTO EMERGING TECHNOLOGIES, CONNECTING DEVELOPERS WITH VA DATA, AND MAKING HUMAN CENTERED DESIGN (HCD).",
  "dateSigned": "2021-01-07",
  "totalObligation": 1138891386.64,
  "totalOutlay": 545978010.74,
  "baseAndAllOptions": 2286261491.42,
  "baseExercisedOptions": 1138891386.64,
  "periodOfPerformance": {
    "start": "2021-01-08",
    "end": "2025-04-15",
    "potentialEnd": "2025-04-15 00:00:00"
  },
  "awardingAgency": {
    "name": "Department of Veterans Affairs",
    "subAgency": "Department of Veterans Affairs"
  },
  "fundingAgency": {
    "name": "Department of Veterans Affairs",
    "subAgency": "Department of Veterans Affairs"
  },
  "recipient": {
    "name": "BOOZ ALLEN HAMILTON INC",
    "uei": "KHK6E1JW9C15",
    "id": "30b32b62-ffbf-d7e6-5b9d-95a295b95a6d-C",
    "parentName": "BOOZ ALLEN HAMILTON HOLDING CORPORATION",
    "parentUei": "MBPHTU7Y9S65",
    "parentId": "ed02855e-60d7-2540-e3d7-18fba1dd1316-P",
    "businessCategories": [
      "Category Business",
      "Corporate Entity Not Tax Exempt"
    ]
  },
  "placeOfPerformance": {
    "city": "HERNDON",
    "state": "VA",
    "zip": "20171",
    "country": "UNITED STATES"
  },
  "naics": {
    "code": "541512",
    "description": "Computer Systems Design Services"
  },
  "psc": {
    "code": "DA01",
    "description": "IT AND TELECOM - BUSINESS APPLICATION/APPLICATION DEVELOPMENT SUPPORT SERVICES (LABOR)"
  },
  "setAside": null,
  "competition": "FULL AND OPEN COMPETITION",
  "numberOfOffers": "9",
  "parentAward": {
    "id": "CONT_IDV_VA11816D1015_3600",
    "awardId": "VA11816D1015",
    "agency": "Department of Veterans Affairs",
    "subAgency": "Department of Veterans Affairs",
    "idvType": "IDC",
    "multipleOrSingleAward": "MULTIPLE AWARD",
  ...

Response fields

Field	Type	Meaning
`awards[].awardId, id`	string	Award number (PIID or FAIN) and the id for /v1/usaspending/award.
`awards[].type, awardType`	string	The type you asked for and the award's own type.
`awards[].recipientName, recipientUei, recipientId`	string	The recipient.
`awards[].amount, outlays, subsidyCost`	number	Obligated amount (loan value for loans), outlays and loan subsidy cost.
`awards[].awardingAgency, awardingSubAgency`	string	Who made the award.
`awards[].startDate, endDate`	string	Period of performance.
`awards[].naics.code, naics.description, psc.code, psc.description`	string	What was bought (contracts and IDVs).
`awards[].cfdaNumber`	string	Assistance listing for grants.
`awards[].placeOfPerformanceState, description`	string	State and award description.
`awards[].secCompany.cik, ticker, name`	object	The listed company behind the recipient, or null.
`hasNext, from, size, source`	mixed	Paging and the data source.
`award: totalObligation, totalOutlay, baseAndAllOptions, baseExercisedOptions`	number	Award amounts.
`award: periodOfPerformance.start, end, potentialEnd`	string	Dates.
`award: awardingAgency, fundingAgency (name, subAgency)`	object	Agencies.
`award: recipient (name, uei, id, parentName, parentUei, parentId, businessCategories)`	object	Recipient and parent.
`award: setAside, competition, numberOfOffers`	mixed	How the contract was competed.
`award: parentAward (id, awardId, agency, subAgency, idvType, multipleOrSingleAward, idcType)`	object	The IDV a task or delivery order sits under.
`award: subawardCount, totalSubawardAmount, executiveCompensation[]`	mixed	Subawards and reported officer pay.
`recipient: name, uei, level, alternateNames, parentName, parentUei, parentId, businessTypes`	mixed	Profile.
`recipient: location (address, city, county, state, zip, country, congressionalDistrict)`	object	Address on file.
`recipient: last12Months.amount, last12Months.transactions`	number	Recent federal awards.
`recipients[].id, name, uei, level, last12MonthsAmount`	mixed	Search results.
`results[].name, code, id, amount`	mixed	Spending totals per group.

Award types

type	Includes
contracts	Definitive contracts, purchase orders, delivery and task orders
idvs	Indefinite delivery vehicles: GWACs, IDIQs, BPAs, BOAs, FSS
grants	Block, formula, project and cooperative agreements
loans	Direct and guaranteed loans
direct	Direct payments
other	Insurance and other assistance

How to

How do I get a company's awards including subsidiaries?

Find its parent with /v1/usaspending/recipients (level P) and query awards by the parent's uei.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/usaspending/awards?uei=ZFN2JJXBLZT3&startDate=2026-01-01&size=2"

How do I search grants instead of contracts?

Set type=grants.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/usaspending/awards?type=grants&q=broadband&startDate=2026-01-01&size=2"

How do I find a recipient's id?

Search by name; each result has id, uei and level.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/usaspending/recipients?q=lockheed%2520martin&size=3"

How do I see which agencies spend most in a NAICS code?

Group spending by awarding_agency.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/usaspending/spending?by=awarding_agency&naics=541512&startDate=2026-01-01&size=3"

How do I filter by agency?

agency takes the exact top-tier agency name.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/usaspending/awards?agency=Department%2520of%2520Veterans%2520Affairs&startDate=2026-10-01&size=2"

How do I get recent awards instead of the largest?

Sort by startDate.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/usaspending/awards?naics=541512&startDate=2026-09-01&sort=startDate&size=2"

How do I look at small business set-aside awards?

Pass setAside codes.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/usaspending/awards?setAside=SBA&naics=561720&startDate=2026-01-01&size=2"

How do I page through results?

Use size and from in multiples of size until hasNext is false.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/usaspending/awards?naics=541512&startDate=2026-10-01&size=2&from=2"

Errors

400 when from is not a multiple of size, a date is not YYYY-MM-DD, or USAspending rejects a filter (its message is passed on).
404 for an unknown award or recipient id.

Try it with your own key

Free key, no card needed.

Get free API key →