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

ParamInValues
completion_from, completion_toqueryUltimate completion date range, YYYY-MM-DD (default: today to today + 180 days)
naicsqueryNAICS code, or a comma list of up to 100, e.g. 541512,541511
agency_codequeryContracting department code, 4 characters, e.g. 9700 (DoD), 3600 (VA)
awardee_ueiqueryAwardee Unique Entity ID, 12 characters
piidqueryContract PIID
set_asidequerySet-aside code, e.g. SBA, 8A, WOSB, HZC
min_valuequeryMinimum ultimate contract value (base + all options), USD
award_typequeryaward or idv
limitquery1–100 (default 50), records requested from SAM before collapsing
offsetqueryPage 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"
}

US government data from GSA's public SAM.gov Contract Awards API. Defense contracts appear 90 days after signing. A completion date is when a contract can end, not a promise it will be recompeted; options and extensions can move it. Results are cached for up to 6 hours. No matches returns count: 0 and is free. Cost: 2 credits.