Skip to main content
POST
/
api
/
usaspending
/
awards
/
search
/usaspending/awards/search
curl --request POST \
  --url https://api.anysite.io/api/usaspending/awards/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keywords": [
    "<string>"
  ],
  "award_type_codes": [],
  "count": 2,
  "timeout": 300,
  "start_date": "2020-01-01",
  "end_date": "2024-12-31",
  "sort": "Award Amount",
  "order": "desc"
}
'
[
  {
    "id": "<string>",
    "@type": "@usaspending_award_search_result",
    "internal_id": 123,
    "award_id": "<string>",
    "recipient_name": "<string>",
    "recipient_id": "<string>",
    "award_amount": 123,
    "total_outlay": 123,
    "award_type": "<string>",
    "awarding_agency": "<string>",
    "awarding_sub_agency": "<string>",
    "funding_agency": "<string>",
    "funding_sub_agency": "<string>",
    "start_date": "<string>",
    "end_date": "<string>",
    "last_modified_date": "<string>",
    "description": "<string>",
    "agency_slug": "<string>"
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
keywords
string[]
required

Text terms to match against awards

Minimum array length: 1
Examples:
["Lockheed"]
["solar", "energy"]
​
award_type_codes
enum<string>[]
required

Award types to include. All codes must belong to the same award group (contracts, IDVs, grants, loans, direct payments, or other financial assistance)

Minimum array length: 1
Available options:
A,
B,
C,
D,
IDV_A,
IDV_B,
IDV_B_A,
IDV_B_B,
IDV_B_C,
IDV_C,
IDV_D,
IDV_E,
02,
03,
04,
05,
06,
07,
08,
09,
10,
11
Examples:
["A", "B", "C", "D"]
["02", "03", "04", "05"]
​
count
integer
required

Number of awards to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
start_date
string | null

Filter awards active on or after this date (YYYY-MM-DD)

Example:

"2020-01-01"

​
end_date
string | null

Filter awards active on or before this date (YYYY-MM-DD)

Example:

"2024-12-31"

​
sort
enum<string>
default:Award Amount

Field to sort results by

Available options:
Award Amount,
Total Outlays,
Start Date,
End Date,
Recipient Name,
Award ID,
Last Modified Date,
Awarding Agency
​
order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc

Response

Successful Response

​
id
string
required
​
@type
string
default:@usaspending_award_search_result
​
internal_id
integer | null
​
award_id
string | null
​
recipient_name
string | null
​
recipient_id
string | null
​
award_amount
number | null
​
total_outlay
number | null
​
award_type
string | null
​
awarding_agency
string | null
​
awarding_sub_agency
string | null
​
funding_agency
string | null
​
funding_sub_agency
string | null
​
start_date
string | null
​
end_date
string | null
​
last_modified_date
string | null
​
description
string | null
​
agency_slug
string | null