Awards

GET/api/v2/awards/{award_id}/

Powers Award summaries on usaspending.gov How an award summary is built

This endpoint is used to power USAspending.gov's award profile pages. This data can be used to view details about a specific award.

This endpoint returns a list of data that is associated with the Award.

Request

curl 'https://api.usaspending.gov/api/v2/awards/CONT_AWD_H907_9700_SPE2DX16D1500_9700/'

Path parameters

award_idstringRequired
Example CONT_AWD_H907_9700_SPE2DX16D1500_9700

Try it

Runs against the live API. Responses are real data.

GET/api/v2/awards/CONT_AWD_H907_9700_SPE2DX16D1500_9700/

award_id path, required

Response · 200

idnumberRequired
categoryenum (string)Required
Allowed values
- contract
typeenum (string)Required
Allowed values
- A
- B
- C
- D
type_descriptionstringRequired
generated_unique_award_idstringRequired
piidstringRequired
Award id
descriptionstringRequiredNullable
Description of the first transaction for this award
total_obligationnumberRequired
base_exercised_optionsnumberRequiredNullable
base_and_all_optionsnumberRequired
The ceiling and amount of the award
date_signedstringRequiredNullable
subaward_countnumberRequired
total_subaward_amountnumberRequiredNullable
awarding_agencyobject · AgencyRequired5 fields
- idnumberRequired
- has_agency_pagebooleanRequired
- toptier_agencyobject · TopTierAgencyRequiredNullable4 fields
  - namestringRequiredNullable
  - codestringRequired
  - abbreviationstringRequiredNullable
  - slugstringRequiredNullable
- subtier_agencyobject · SubTierAgencyRequiredNullable3 fields
  - namestringRequiredNullable
  - codestringRequired
  - abbreviationstringRequiredNullable
- office_agency_namestringRequiredNullable
funding_agencyobject · AgencyRequiredNullable5 fields
- idnumberRequired
- has_agency_pagebooleanRequired
- toptier_agencyobject · TopTierAgencyRequiredNullable4 fields
  - namestringRequiredNullable
  - codestringRequired
  - abbreviationstringRequiredNullable
  - slugstringRequiredNullable
- subtier_agencyobject · SubTierAgencyRequiredNullable3 fields
  - namestringRequiredNullable
  - codestringRequired
  - abbreviationstringRequiredNullable
- office_agency_namestringRequiredNullable
recipientobject · RecipientRequired10 fields
- recipient_namestringRequiredNullable
- recipient_hashstringRequiredNullable
- recipient_ueistringRequiredNullable
- recipient_unique_idstringRequiredNullable
  The recipient's DUNS
- parent_recipient_namestringNullable
- parent_recipient_hashstringNullable
- parent_recipient_ueistringRequiredNullable
- parent_recipient_unique_idstringRequiredNullable
  The recipient's parent's DUNS
- locationobject · LocationRequiredNullable15 fields
  The recipient's location
  - address_line1stringRequiredNullable
  - address_line2stringRequiredNullable
  - address_line3stringRequiredNullable
  - foreign_provincestringRequiredNullable
  - city_namestringRequiredNullable
  - county_codestringRequiredNullable
  - county_namestringRequiredNullable
  - state_codestringRequiredNullable
  - state_namestringRequiredNullable
  - zip5stringRequiredNullable
  - zip4stringRequiredNullable
  - foreign_postal_codestringRequiredNullable
  - country_namestringRequiredNullable
  - location_country_codestringRequiredNullable
  - congressional_codestringRequiredNullable
- business_categoriesarray of stringRequired
  Names of the recipients' business categories in human readable format
period_of_performanceobject · PeriodOfPerformanceRequired4 fields
- start_datestringRequired
- end_datestringRequired
  Corresponds to database fields current_end_date for contracts and ordering_period_end_date for IDVs
- last_modified_datestringRequired
- potential_end_datestringRequiredNullable
place_of_performanceobject · LocationRequired15 fields
- address_line1stringRequiredNullable
- address_line2stringRequiredNullable
- address_line3stringRequiredNullable
- foreign_provincestringRequiredNullable
- city_namestringRequiredNullable
- county_codestringRequiredNullable
- county_namestringRequiredNullable
- state_codestringRequiredNullable
- state_namestringRequiredNullable
- zip5stringRequiredNullable
- zip4stringRequiredNullable
- foreign_postal_codestringRequiredNullable
- country_namestringRequiredNullable
- location_country_codestringRequiredNullable
- congressional_codestringRequiredNullable
latest_transaction_contract_dataobject · ContractDetailsRequired69 fields
- clinger_cohen_act_planningstringRequiredNullable
- clinger_cohen_act_planning_descriptionstringRequiredNullable
- commercial_item_acquisitionstringRequiredNullable
- commercial_item_acquisition_descriptionstringRequiredNullable
- commercial_item_test_programstringRequiredNullable
- commercial_item_test_program_descriptionstringRequiredNullable
- consolidated_contractstringRequiredNullable
- consolidated_contract_descriptionstringRequiredNullable
- construction_wage_ratestringRequiredNullable
- construction_wage_rate_descriptionstringRequiredNullable
- cost_or_pricing_datastringRequiredNullable
- cost_or_pricing_data_descriptionstringRequiredNullable
- dod_acquisition_programstringRequiredNullable
- dod_acquisition_program_descriptionstringRequiredNullable
- dod_claimant_programstringRequiredNullable
- dod_claimant_program_descriptionstringRequiredNullable
- domestic_or_foreign_entitystringRequiredNullable
- domestic_or_foreign_entity_descriptionstringRequiredNullable
- evaluated_preferencestringRequiredNullable
- evaluated_preference_descriptionstringRequiredNullable
- extent_competedstringRequiredNullable
- extent_competed_descriptionstringRequiredNullable
- fair_opportunity_limitedstringRequiredNullable
- fair_opportunity_limited_descriptionstringRequiredNullable
- fed_biz_oppsstringRequiredNullable
- fed_biz_opps_descriptionstringRequiredNullable
- foreign_fundingstringRequiredNullable
- foreign_funding_descriptionstringRequiredNullable
- idv_type_descriptionstringRequiredNullable
- information_technology_commercial_item_categorystringRequiredNullable
- information_technology_commercial_item_category_descriptionstringRequiredNullable
- interagency_contracting_authoritystringRequiredNullable
- interagency_contracting_authority_descriptionstringRequiredNullable
- labor_standardsstringRequiredNullable
- labor_standards_descriptionstringRequiredNullable
- major_programstringRequiredNullable
- materials_suppliesstringRequiredNullable
- materials_supplies_descriptionstringRequiredNullable
- multi_year_contractstringRequiredNullable
- multi_year_contract_descriptionstringRequiredNullable
- multiple_or_single_award_descriptionstringRequiredNullable
- naicsstringRequiredNullable
- naics_descriptionstringRequiredNullable
- national_interest_actionstringRequiredNullable
- national_interest_action_descriptionstringRequiredNullable
- number_of_offers_receivedstringRequiredNullable
- other_than_full_and_openstringRequiredNullable
- other_than_full_and_open_descriptionstringRequiredNullable
- price_evaluation_adjustmentstringRequiredNullable
- product_or_service_codestringRequiredNullable
- product_or_service_descriptionstringRequiredNullable
- program_acronymstringRequiredNullable
- purchase_card_as_payment_methodstringRequiredNullable
- purchase_card_as_payment_method_descriptionstringRequiredNullable
- referenced_idv_agency_idenstringRequiredNullable
- referenced_idv_agency_descstringRequiredNullable
- sea_transportationstringRequiredNullable
- sea_transportation_descriptionstringRequiredNullable
- small_business_competitivebooleanRequiredNullable
- solicitation_identifierstringRequiredNullable
- solicitation_proceduresstringRequiredNullable
- solicitation_procedures_descriptionstringRequiredNullable
- subcontracting_planstringRequiredNullable
- subcontracting_plan_descriptionstringRequiredNullable
- type_of_contract_pricingstringRequiredNullable
- type_of_contract_pricing_descriptionstringRequiredNullable
- type_of_idc_descriptionstringRequiredNullable
- type_set_asidestringRequiredNullable
- type_set_aside_descriptionstringRequiredNullable
executive_detailsobject · ExecutiveRequired1 field
- officersarray of OfficerRequired2 fields
  - namestringRequiredNullable
  - amountnumberRequiredNullable
parent_awardobject · ParentDetailsRequiredNullable11 fields
null if the contract has no parent
- agency_idnumberRequired
- agency_namestringRequired
- agency_slugstringRequiredNullable
  agency_slug is a string used to generate a link to the agency profile page. Will be NULL if the agency does not have a profile page.
- sub_agency_idstringRequired
- sub_agency_namestringRequired
- award_idnumberRequiredNullable
- generated_unique_award_idstringRequired
- idv_type_descriptionstringRequiredNullable
- multiple_or_single_aw_descstringRequired
- piidstringRequired
- type_of_idc_descriptionstringRequiredNullable
naics_hierarchyobject · NAICSHierarchyRequired3 fields
- toptier_codeobject · HierarchyLeafRequired2 fields
  - descriptionstring
  - codestring
- midtier_codeobject · HierarchyLeafRequired2 fields
  - descriptionstring
  - codestring
- base_codeobject · HierarchyLeafRequired2 fields
  - descriptionstring
  - codestring
psc_hierarchyobject · PSCHierarchyRequired4 fields
- toptier_codeobject · HierarchyLeafRequired2 fields
  - descriptionstring
  - codestring
- midtier_codeobject · HierarchyLeafRequired2 fields
  - descriptionstring
  - codestring
- subtier_codeobject · HierarchyLeafRequired2 fields
  - descriptionstring
  - codestring
- base_codeobject · HierarchyLeafRequired2 fields
  - descriptionstring
  - codestring
total_account_outlaynumberRequired
total_account_obligationnumberRequired
account_obligations_by_defcarray of DEFCAmountRequired2 fields
- codestringRequired
- amountnumberRequired
account_outlays_by_defcarray of DEFCAmountRequired2 fields
- codestringRequired
- amountnumberRequired

Example response

{
  "id": 22834500,
  "generated_unique_award_id": "CONT_AWD_H907_9700_SPE2DX16D1500_9700",
  "piid": "H907",
  "category": "contract",
  "type": "C",
  "type_description": "DELIVERY ORDER",
  "description": "4534723185!PV PHARM BRANCH, VENDOR, CAGE 0U9U0",
  "total_obligation": 61241.34,
  "subaward_count": 0,
  "total_subaward_amount": null,
  "date_signed": "2016-06-24",
  "base_exercised_options": 61241.34,
  "base_and_all_options": 61241.34,
  "parent_award": {
    "agency_id": 1173,
    "agency_name": "Department of Defense",
    "agency_slug": "department-of-defense",
    "sub_agency_id": "9700",
    "sub_agency_name": "Department of Defense",
    "award_id": 69513842,
    "generated_unique_award_id": "CONT_IDV_SPE2DX16D1500_9700",
    "idv_type_description": "IDC",
    "multiple_or_single_aw_desc": "SINGLE AWARD",
    "piid": "SPE2DX16D1500",
    "type_of_idc_description": "INDEFINITE DELIVERY / INDEFINITE QUANTITY"
  },
  "latest_transaction_contract_data": {
    "idv_type_description": null,
    "type_of_idc_description": null,
    "referenced_idv_agency_iden": "9700",
    "referenced_idv_agency_desc": "DEPT OF DEFENSE",
    "solicitation_identifier": null,
    "solicitation_procedures": "NP",
    "number_of_offers_received": "4",
    "extent_competed": "A",
    "type_set_aside": "NONE",
    "type_set_aside_description": "NO SET ASIDE USED.",
    "evaluated_preference": "NONE",
    "fed_biz_opps": "N",
    "fed_biz_opps_description": "NO",
    "small_business_competitive": false,
    "product_or_service_code": "6505",
    "naics": "325411",
    "naics_description": "MEDICINAL AND BOTANICAL MANUFACTURING",
    "sea_transportation": "U",
    "clinger_cohen_act_planning": "N",
    "labor_standards": "X",
    "cost_or_pricing_data": "N",
    "domestic_or_foreign_entity": "A",
    "foreign_funding": "X",
    "major_program": null,
    "program_acronym": null,
    "subcontracting_plan": null,
    "multi_year_contract": "N",
    "consolidated_contract": "N",
    "type_of_contract_pricing": "J",
    "national_interest_action": "NONE",
    "national_interest_action_description": "NONE",
    "multiple_or_single_award_description": null,
    "solicitation_procedures_description": "NEGOTIATED PROPOSAL/QUOTE",
    "extent_competed_description": "FULL AND OPEN COMPETITION",
    "other_than_full_and_open": null,
    "other_than_full_and_open_description": null,
    "commercial_item_acquisition": "D",
    "commercial_item_acquisition_description": "COMMERCIAL ITEM PROCEDURES NOT USED",
    "commercial_item_test_program": "N",
    "commercial_item_test_program_description": "NO",
    "evaluated_preference_description": "NO PREFERENCE USED",
    "fair_opportunity_limited": null,
    "fair_opportunity_limited_description": null,
    "product_or_service_description": "DRUGS AND BIOLOGICALS",
    "dod_claimant_program": "C9B",
    "dod_claimant_program_description": "MEDICAL AND DENTAL SUPPLIES AND EQUIPMENT",
    "dod_acquisition_program": "000",
    "dod_acquisition_program_description": "NONE",
    "information_technology_commercial_item_category": "Z",
    "information_technology_commercial_item_category_description": "NOT IT PRODUCTS OR SERVICES",
    "sea_transportation_description": "UNKNOWN",
    "clinger_cohen_act_planning_description": "NO",
    "construction_wage_rate": "X",
    "construction_wage_rate_description": "NOT APPLICABLE",
    "labor_standards_description": "NOT APPLICABLE",
    "materials_supplies": "N",
    "materials_supplies_description": "NO",
    "cost_or_pricing_data_description": "NO",
    "domestic_or_foreign_entity_description": "U.S. OWNED BUSINESS",
    "foreign_funding_description": "NOT APPLICABLE",
    "interagency_contracting_authority": "X",
    "interagency_contracting_authority_description": "NOT APPLICABLE",
    "price_evaluation_adjustment": null,
    "subcontracting_plan_description": null,
    "multi_year_contract_description": "NO",
    "purchase_card_as_payment_method": "N",
    "purchase_card_as_payment_method_description": "NO",
    "consolidated_contract_description": "NO",
    "type_of_contract_pricing_description": "FIRM FIXED PRICE"
  },
  "funding_agency": {
    "id": 1219,
    "has_agency_page": true,
    "toptier_agency": {
      "name": "Department of Defense",
      "code": "097",
      "abbreviation": "DOD",
      "slug": "department-of-defense"
    },
    "subtier_agency": {
      "name": "Defense Logistics Agency",
      "code": "97AS",
      "abbreviation": "DLA"
    },
    "office_agency_name": "DLA TROOP SUPPORT"
  },
  "awarding_agency": {
    "id": 1219,
    "has_agency_page": true,
    "toptier_agency": {
      "name": "Department of Defense",
      "code": "097",
      "abbreviation": "DOD",
      "slug": "department-of-defense"
    },
    "subtier_agency": {
      "name": "Defense Logistics Agency",
      "code": "97AS",
      "abbreviation": "DLA"
    },
    "office_agency_name": "DLA TROOP SUPPORT"
  },
  "period_of_performance": {
    "start_date": "2016-06-24",
    "end_date": "2016-06-27",
    "last_modified_date": "2019-10-27 20:06:44",
    "potential_end_date": "2016-06-27 00:00:00"
  },
  "recipient": {
    "recipient_hash": "a704b6c0-d296-fc75-79e9-7a9546b3b634-C",
    "recipient_name": "MCKESSON CORPORATION",
    "recipient_uei": "JTAPCFM4NSL4",
    "recipient_unique_id": "105919864",
    "parent_recipient_hash": "8b51f520-c590-0517-1e0d-45336a1b9332-P",
    "parent_recipient_name": "MCKESSON CORPORATION",
    "parent_recipient_uei": "S1RUKWWRYFL6",
    "parent_recipient_unique_id": "177667227",
    "business_categories": [
      "Category Business",
      "Corporate Entity Not Tax Exempt",
      "Not Designated a Small Business",
      "Special Designations",
      "U.S.-Owned Business"
    ],
    "location": {
      "location_country_code": "USA",
      "country_name": "UNITED STATES",
      "state_code": "CA",
      "state_name": "CALIFORNIA",
      "city_name": "WEST SACRAMENTO",
      "county_code": "113",
      "county_name": "YOLO",
      "address_line1": "3775 SEAPORT BLVD",
      "address_line2": null,
      "address_line3": null,
      "congressional_code": "06",
      "zip4": "3558",
      "zip5": "95691",
      "foreign_postal_code": null,
      "foreign_province": null
    }
  },
  "executive_details": {
    "officers": [
      {
        "name": null,
        "amount": null
      },
      {
        "name": null,
        "amount": null
      },
      {
        "name": null,
        "amount": null
      },
      {
        "name": null,
        "amount": null
      },
      {
        "name": null,
        "amount": null
      }
    ]
  },
  "place_of_performance": {
    "location_country_code": "USA",
    "country_name": "UNITED STATES",
    "county_code": "113",
    "county_name": "YOLO",
    "city_name": "WEST SACRAMENTO",
    "state_code": "CA",
    "state_name": "CALIFORNIA",
    "congressional_code": "06",
    "zip4": "3558",
    "zip5": "95691",
    "address_line1": null,
    "address_line2": null,
    "address_line3": null,
    "foreign_province": null,
    "foreign_postal_code": null
  },
  "psc_hierarchy": {
    "toptier_code": {},
    "midtier_code": {
      "code": "65",
      "description": "MEDICAL/DENTAL/VETERINARY EQPT/SUPP"
    },
    "subtier_code": {},
    "base_code": {
      "code": "6505",
      "description": "DRUGS AND BIOLOGICALS"
    }
  },
  "naics_hierarchy": {
    "toptier_code": {
      "code": "32",
      "description": "Manufacturing"
    },
    "midtier_code": {
      "code": "3254",
      "description": "Pharmaceutical and Medicine Manufacturing"
    },
    "base_code": {
      "code": "325411",
      "description": "Medicinal and Botanical Manufacturing"
    }
  },
  "total_account_outlay": 3,
  "total_account_obligation": 3,
  "account_outlays_by_defc": [
    {
      "code": "P",
      "amount": 2
    },
    {
      "code": "L",
      "amount": 1
    }
  ],
  "account_obligations_by_defc": [
    {
      "code": "P",
      "amount": 2
    },
    {
      "code": "L",
      "amount": 1
    }
  ]
}

Recent changes

May 6, 2025Mentioned in the May 06, 2025 release notes
December 19, 2024DEV-11832: Add funding_opportunity_* to Award endpoint response
January 18, 2022Mentioned in the January 18, 2022 release notes
March 23, 2021Mentioned in the March 23, 2021 release notes
August 7, 2020Mentioned in the August 07, 2020 release notes

Contract notes

The contract doesn't declare award_id in its URL template, so it was added here from the path.

Generated from contracts/v2/awards/award_id.md in the USAspending API repo.