Skip to main content
POST
/
api
/
usaspending
/
awards
/usaspending/awards
curl --request POST \
  --url https://api.anysite.io/api/usaspending/awards \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "award": "<string>",
  "timeout": 300
}
'
[
  {
    "id": 123,
    "generated_unique_award_id": "<string>",
    "@type": "@usaspending_award",
    "piid": "<string>",
    "fain": "<string>",
    "uri": "<string>",
    "category": "<string>",
    "type": "<string>",
    "type_description": "<string>",
    "description": "<string>",
    "total_obligation": 123,
    "total_outlay": 123,
    "base_and_all_options": 123,
    "base_exercised_options": 123,
    "total_subsidy_cost": 123,
    "total_loan_value": 123,
    "subaward_count": 0,
    "total_subaward_amount": 123,
    "date_signed": "<string>",
    "record_type": 123,
    "naics": "<string>",
    "naics_description": "<string>",
    "psc": "<string>",
    "psc_description": "<string>",
    "awarding_agency": {
      "@type": "@usaspending_agency_ref",
      "id": 123,
      "toptier_name": "<string>",
      "toptier_code": "<string>",
      "toptier_abbreviation": "<string>",
      "subtier_name": "<string>",
      "subtier_code": "<string>",
      "subtier_abbreviation": "<string>",
      "office_agency_name": "<string>"
    },
    "funding_agency": {
      "@type": "@usaspending_agency_ref",
      "id": 123,
      "toptier_name": "<string>",
      "toptier_code": "<string>",
      "toptier_abbreviation": "<string>",
      "subtier_name": "<string>",
      "subtier_code": "<string>",
      "subtier_abbreviation": "<string>",
      "office_agency_name": "<string>"
    },
    "recipient": {
      "@type": "@usaspending_award_recipient",
      "name": "<string>",
      "uei": "<string>",
      "recipient_hash": "<string>",
      "parent_name": "<string>",
      "parent_uei": "<string>",
      "parent_recipient_hash": "<string>",
      "business_categories": [],
      "location": {
        "@type": "@usaspending_location",
        "country_code": "<string>",
        "country_name": "<string>",
        "state_code": "<string>",
        "state_name": "<string>",
        "city_name": "<string>",
        "county_code": "<string>",
        "county_name": "<string>",
        "congressional_code": "<string>",
        "zip5": "<string>",
        "address_line1": "<string>",
        "foreign_province": "<string>",
        "foreign_postal_code": "<string>"
      }
    },
    "period_of_performance": {
      "@type": "@usaspending_period_of_performance",
      "start_date": "<string>",
      "end_date": "<string>",
      "last_modified_date": "<string>",
      "potential_end_date": "<string>"
    },
    "place_of_performance": {
      "@type": "@usaspending_location",
      "country_code": "<string>",
      "country_name": "<string>",
      "state_code": "<string>",
      "state_name": "<string>",
      "city_name": "<string>",
      "county_code": "<string>",
      "county_name": "<string>",
      "congressional_code": "<string>",
      "zip5": "<string>",
      "address_line1": "<string>",
      "foreign_province": "<string>",
      "foreign_postal_code": "<string>"
    },
    "latest_transaction_contract_data": {
      "@type": "@usaspending_contract_data",
      "naics": "<string>",
      "naics_description": "<string>",
      "product_or_service_code": "<string>",
      "product_or_service_description": "<string>",
      "extent_competed": "<string>",
      "extent_competed_description": "<string>",
      "type_set_aside": "<string>",
      "type_set_aside_description": "<string>",
      "type_of_contract_pricing": "<string>",
      "type_of_contract_pricing_description": "<string>",
      "solicitation_identifier": "<string>",
      "number_of_offers_received": "<string>",
      "idv_type_description": "<string>",
      "dod_acquisition_program_description": "<string>"
    },
    "cfda_info": [],
    "executive_officers": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
award
string
required

Award identifier (generated unique award id)

Minimum string length: 1
Examples:

"CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-"

"ASST_NON_2405CA5MAP_075"

timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

id
integer
required
generated_unique_award_id
string
required
@type
string
default:@usaspending_award
piid
string | null
fain
string | null
uri
string | null
category
string | null
type
string | null
type_description
string | null
description
string | null
total_obligation
number | null
total_outlay
number | null
base_and_all_options
number | null
base_exercised_options
number | null
total_subsidy_cost
number | null
total_loan_value
number | null
subaward_count
integer
default:0
total_subaward_amount
number | null
date_signed
string | null
record_type
integer | null
naics
string | null
naics_description
string | null
psc
string | null
psc_description
string | null
awarding_agency
UsaspendingAgencyRef · object
funding_agency
UsaspendingAgencyRef · object
recipient
UsaspendingAwardRecipient · object
period_of_performance
UsaspendingPeriodOfPerformance · object
place_of_performance
UsaspendingLocation · object
latest_transaction_contract_data
UsaspendingContractData · object
cfda_info
UsaspendingCfda · object[]
executive_officers
UsaspendingExecutiveOfficer · object[]