Federal awards
Federal Contracts
Returns federal contract awards from USAspending.gov — government spending data sourced from Treasury/GSA. Each record is one prime contract award (BPA Call, Purchase Order, Delivery Order, or Definitive Contract).
Endpoint
GET /v1/federal-contractsSourceUSAspending
Authx-api-key — a free key works
What it returns
One record per result. Fields (from a live response):
- Identity —
recipient_name,place_of_performance_state - Subject —
recipient_uei,recipient_id,description,naics_description,psc_description - Dates —
start_date,end_date,last_modified_date - The trade / event —
naics_code,psc_code - Amounts —
award_amount,total_outlays - Provenance —
award_url,data_source - Details —
id,award_id,contract_award_type,awarding_agency,awarding_subagency,def_codes
Filters
| recipient_name | Recipient name substring; case-insensitive match. Example: 'Lockheed Martin' matches 'LOCKHEED MARTIN CORP', 'LOCKHEED MARTIN MISSILES AND FIRE… |
| recipient_uei | Unique Entity Identifier (replaced DUNS in 2022). 12-character alphanumeric. Exact match. |
| awarding_agency | Awarding agency exact name. Examples: 'Department of Defense', 'National Aeronautics and Space Administration', 'Department of Health and Human… |
| naics_code | 6-digit North American Industry Classification System code. Example: '541710' (R&D in Physical/Engineering/Life Sciences). Exact match. |
| psc_code | Product or Service Code (4-character). Example: 'AR33' (R&D Space Flight Advanced Development). Exact match. |
| min_amount | Filter to awards with award_amount >= this value (USD). Use to focus on large contracts. |
| since | ISO date (YYYY-MM-DD). Only records on or after this date, using sort_by as the date field. |
| until | ISO date (YYYY-MM-DD). Only records on or before this date. |
| sort_by | Field used for ordering and for the since/until filters. Default: last_modified_date (most-recently-modified first). |
| sort_order | Default: desc. |
| limit | Maximum records to return. Default 50, max 500. |
Example request
curl "https://api.keyvex.com/v1/federal-contracts?limit=1" \
-H "x-api-key: YOUR_KEY"
Response
{
"results": [
{
"id": "CONT_AWD_140A0926P0051_1450_-NONE-_-NONE-",
"award_id": "140A0926P0051",
"recipient_name": "WAGNER EQUIPMENT CO",
"recipient_uei": "J2MMHNT7C4L9",
"recipient_id": "3a29bb13-22af-1e64-5872-59533fa5da31-C",
"award_amount": 10774,
"total_outlays": 0,
"description": "I60174T REPAIR OF GOOSENECK TRAILER, BIA, CHINLE AGENCY, BOT",
"contract_award_type": "PURCHASE ORDER",
"awarding_agency": "Department of the Interior",
"awarding_subagency": "Bureau of Indian Affairs and Bureau of Indian Education",
"naics_code": "811310",
"naics_description": "COMMERCIAL AND INDUSTRIAL MACHINERY AND EQUIPMENT (EXCEPT AUTOMOTIVE AND ELECTRONIC) REPAIR AND MAINTENANCE",
"psc_code": "J028",
"psc_description": "MAINT/REPAIR/REBUILD OF EQUIPMENT- ENGINES, TURBINES, AND COMPONENTS",
"def_codes": [],
"start_date": "2026-06-21",
"end_date": "2026-09-30",
"last_modified_date": "2026-06-21T23:37:41",
"place_of_performance_state": "NM",
"award_url": "https://www.usaspending.gov/award/CONT_AWD_140A0926P0051_1450_-NONE-_-NONE-/",
"data_source": "USASPENDING"
}
],
"count": 1,
"has_more": true
}
Example questions you can answer
- Largest federal contract awards to a company.
- Contracts by agency in a date range.
Related datasets
Query Federal Contracts from your AI
Hand any AI your key + the OpenAPI spec and it can pull this dataset directly. Free key = full data, 60 requests/day.
Get a free key OpenAPI spec → REST docs →