Run U.S. federal contract search.

U.S. federal contract search returns structured JSON. This example is static; the paid call returns a fresh result and settlement receipt.

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.us-contract-search",
  "version": "1",
  "data": {
    "query": {
      "recipientQuery": "Palantir USG",
      "recipientFieldsSearched": [
        "name",
        "UEI",
        "legacy DUNS"
      ],
      "startDate": "2024-01-01",
      "endDate": "2026-08-13",
      "minimumAwardAmountUsd": 1000000,
      "maximumAwardAmountUsd": null,
      "awardTypeCodes": [
        "A",
        "B",
        "C",
        "D"
      ],
      "awardScope": "prime contracts",
      "sort": "award amount descending",
      "maxResults": 5
    },
    "resultsReceived": 5,
    "awardsReturned": 5,
    "awardsSkipped": 0,
    "hasMore": true,
    "awards": [
      {
        "internalId": 355423040,
        "awardId": "W9128Z26FA001",
        "recipientName": "PALANTIR USG INC",
        "recipientUei": "HNN4F9JZWDY8",
        "awardAmountUsd": 545578476.94,
        "awardType": "DELIVERY ORDER",
        "description": "CDAO MSS TASK ORDER OFF OF CONTRACT W519TC25D0039",
        "startDate": "2025-10-15",
        "endDate": "2029-05-31",
        "lastModifiedAtSource": "2026-05-14 13:09:08",
        "awardingAgency": "Department of Defense",
        "awardingSubAgency": "Department of the Army",
        "fundingAgency": "Department of Defense",
        "fundingSubAgency": "Department of the Army",
        "generatedInternalId": "CONT_AWD_W9128Z26FA001_9700_W519TC25D0039_9700",
        "officialAwardUrl": "https://www.usaspending.gov/award/CONT_AWD_W9128Z26FA001_9700_W519TC25D0039_9700/"
      }
    ],
    "sourceMessages": [
      "USAspending search dates are limited to records from 2007-10-01 onward."
    ],
    "source": "https://api.usaspending.gov/api/v2/search/spending_by_award/",
    "documentation": "https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/search/spending_by_award.md",
    "retrievedAt": "2026-08-13T07:00:00+00:00",
    "limitations": [
      "Recipient search is fuzzy across names, UEIs, and legacy DUNS values; a result does not prove identity, ownership, affiliation, or current status.",
      "Award Amount is USAspending's current aggregate award value, not necessarily cash paid, current obligations, revenue, profit, or remaining contract value.",
      "Results are prime contracts only, sorted by aggregate award amount, limited to page one and the requested date range, and may be revised or incomplete."
    ],
    "disclaimer": "Public federal procurement evidence for research only; verify the official award record before legal, compliance, credit, investment, or contracting decisions."
  },
  "meta": {
    "duration_ms": 42,
    "cached": false,
    "sources": [],
    "warnings": [],
    "next_actions": [
      {
        "service": "research.lei-entity-search",
        "title": "GLEIF legal entity search",
        "reason": "Resolve a selected contract recipient against official GLEIF legal-entity records before combining organization evidence.",
        "method": "POST",
        "path": "/v1/research/lei-entity-search",
        "price": "$0.01",
        "input_template": {
          "legal_name": "$result.data.awards[0].recipientName",
          "country_code": "US",
          "max_results": 3
        },
        "use_output": "Run only after selecting the intended award recipient; a name match does not prove that the GLEIF entity and USAspending recipient are the same organization.",
        "authorization_required": true
      }
    ]
  }
}