Docs / Government data
SAM.gov Contract Awards API
GET /v1/contract-awards
Federal contract awards from SAM.gov's Contract Awards API, the successor to the FPDS
ATOM feed, filtered by ultimate completion date: the contracts that are ending, which is where
recompetes come from. Defaults to contracts ending in the next 180 days. SAM returns a row per contract
action, so rows are collapsed to the latest action per contract (collapsed says how many
were folded). For award totals by action date, use /v1/awards.
Parameters
| Param | In | Values |
|---|---|---|
completion_from, completion_to | query | Ultimate completion date range, YYYY-MM-DD (default: today to today + 180 days) |
naics | query | NAICS code, or a comma list of up to 100, e.g. 541512,541511 |
agency_code | query | Contracting department code, 4 characters, e.g. 9700 (DoD), 3600 (VA) |
awardee_uei | query | Awardee Unique Entity ID, 12 characters |
piid | query | Contract PIID |
set_aside | query | Set-aside code, e.g. SBA, 8A, WOSB, HZC |
min_value | query | Minimum ultimate contract value (base + all options), USD |
award_type | query | award or idv |
limit | query | 1–100 (default 50), records requested from SAM before collapsing |
offset | query | Page offset (default 0) |
Request
# IT services contracts worth $1M+ ending between Nov 2026 and Apr 2027
curl "https://api.edgrapi.com/v1/contract-awards?naics=541512&min_value=1000000&completion_from=2026-11-01&completion_to=2027-04-30" -H "X-API-Key: edgr_..."
Response
{
"scope": "federal contract awards by completion date (SAM.gov Contract Awards)",
"count": 1, "total": 1840, "limit": 50, "offset": 0,
"completion_from": "2026-11-01", "completion_to": "2027-04-30",
"rows_returned": 50, "collapsed": 12,
"awards": [
{ "piid": "36C10B22N0051EHRM", "modification_number": "P00014",
"referenced_idv_piid": "36C10B18D5000", "award_or_idv": "AWARD",
"award_type": "DELIVERY ORDER", "agency": "VETERANS AFFAIRS, DEPARTMENT OF",
"agency_code": "3600", "sub_agency": "VETERANS AFFAIRS, DEPARTMENT OF",
"office": "TECHNOLOGY ACQUISITION CENTER", "awardee": "EXAMPLE FEDERAL SERVICES INC",
"awardee_uei": "ABCDEF123456", "naics_code": "541512",
"naics_name": "COMPUTER SYSTEMS DESIGN SERVICES", "psc_code": "DA01",
"psc_name": "IT AND TELECOM - BUSINESS APPLICATION/APPLICATION DEVELOPMENT SUPPORT SERVICES",
"extent_competed": "FULL AND OPEN COMPETITION", "set_aside": null,
"date_signed": "2026-03-02", "period_of_performance_start": "2022-09-28",
"current_completion_date": "2027-03-31", "ultimate_completion_date": "2027-03-31",
"action_obligation": 0.0, "total_obligation": 2120623737.86,
"total_base_and_all_options_value": 2350000000.0, "place_of_performance_state": "KS" }
],
"source": "SAM.gov Contract Awards API (open.gsa.gov), successor to the FPDS ATOM feed"
}