Spending data by Award (i.e. a grant, contract, loan, etc)

This endpoint allows you to search and filter by almost any attribute of an award object.

GET /api/v1/awards/?awarding_agency__toptier_agency__cgac_code=097&id=172172
HTTP 200 OK
  Allow: GET, POST, HEAD, OPTIONS
  Cache-Trace: no-cache
  Content-Type: application/json
  Vary: Accept
  
  {
    "page_metadata": {
        "count": 1,
        "page": 1,
        "has_next_page": false,
        "has_previous_page": false,
        "next": null,
        "current": "https://api.usaspending.gov/api/v1/awards/?awarding_agency__toptier_agency__cgac_code=097&id=172172&limit=100&page=1",
        "previous": null
    },
    "results": [
        {
            "id": 172172,
            "date_signed__fy": 2011,
            "type": "C",
            "type_description": "DO",
            "category": "contract",
            "piid": "0001",
            "fain": null,
            "uri": null,
            "total_obligation": "17901.84",
            "total_outlay": null,
            "total_subsidy_cost": null,
            "total_loan_value": null,
            "date_signed": "2011-01-19",
            "description": "TASK ORDER 3 NSSE SVCS",
            "period_of_performance_start_date": "2011-01-19",
            "period_of_performance_current_end_date": "2011-01-25",
            "potential_total_value_of_award": null,
            "certified_date": "2011-04-12",
            "total_subaward_amount": "0.00",
            "subaward_count": 0,
            "awarding_agency": {
                "id": 1188,
                "toptier_flag": false,
                "toptier_agency": {
                    "cgac_code": "097",
                    "fpds_code": "9700",
                    "abbreviation": "DOD",
                    "name": "Department of Defense"
                },
                "subtier_agency": {
                    "subtier_code": "2100",
                    "abbreviation": "USA",
                    "name": "Department of the Army"
                },
                "office_agency": null
            },
            "funding_agency": {
                "id": 1188,
                "toptier_flag": false,
                "toptier_agency": {
                    "cgac_code": "097",
                    "fpds_code": "9700",
                    "abbreviation": "DOD",
                    "name": "Department of Defense"
                },
                "subtier_agency": {
                    "subtier_code": "2100",
                    "abbreviation": "USA",
                    "name": "Department of the Army"
                },
                "office_agency": null
            },
            "recipient": {
                "legal_entity_id": 36994286,
                "recipient_name": "GREYHOUND LINES, INC.",
                "parent_recipient_unique_id": "423587252",
                "business_types": null,
                "business_types_description": null,
                "business_categories": [
                    "other_than_small_business",
                    "corporate_entity_not_tax_exempt",
                    "category_business",
                    "us_owned_business",
                    "special_designations"
                ],
                "recipient_unique_id": "825063233",
                "domestic_or_foreign_entity_description": "U.S. OWNED BUSINESS",
                "small_business_description": null,
                "location": {
                    "location_country_code": "UNITED STATES",
                    "country_name": null,
                    "state_code": "TX",
                    "state_name": null,
                    "state_description": null,
                    "city_name": "DALLAS",
                    "address_line1": "350 N SAINT PAUL ST STE 300",
                    "address_line2": null,
                    "address_line3": null,
                    "foreign_location_description": null,
                    "zip5": null,
                    "foreign_postal_code": null,
                    "foreign_province": null,
                    "foreign_city_name": null
                }
            },
            "place_of_performance": {
                "location_country_code": "USA",
                "country_name": "UNITED STATES",
                "state_code": "DC",
                "state_name": "DISTRICT OF COLUMBIA",
                "state_description": null,
                "city_name": "WASHINGTON",
                "address_line1": null,
                "address_line2": null,
                "address_line3": null,
                "foreign_location_description": null,
                "zip5": "20001",
                "foreign_postal_code": null,
                "foreign_province": null,
                "foreign_city_name": null
            },
            "latest_transaction": {
                "type_description": "DO",
                "action_type_description": "CHANGE ORDER",
                "description": "BASE- TASK:  3 NSSE",
                "assistance_data": null,
                "contract_data": {
                    "piid": "0001",
                    "parent_award_id": "W912DR10D0035",
                    "type_of_contract_pricing": "S",
                    "naics": "485113",
                    "naics_description": "BUS AND OTHER MOTOR VEHICLE TRANSIT SYSTEMS",
                    "award_description": "BASE- TASK:  3 NSSE",
                    "action_type_description": "CHANGE ORDER",
                    "idv_type_description": null,
                    "type_of_idc_description": "NAN",
                    "cost_or_pricing_data": "N",
                    "extent_compete_description": "FULL AND OPEN COMPETITION AFTER EXCLUSION OF SOURCES",
                    "fed_biz_opps_description": "NOT APPLICABLE",
                    "product_or_service_code": "V212",
                    "research_description": "NAN",
                    "type_set_aside_description": "NO SET ASIDE USED.",
                    "sam_exception_description": "NAN"
                }
            }
        }
    ]
}
The mechanism used to distribute funding. The federal government can distribute funding in several forms. These award types include contracts, grants, loans, and direct payments.
The plain text description of the type of the award
A field that generalizes the award's type.
Procurement Instrument Identifier - A unique identifier assigned to a federal contract, purchase order, basic ordering agreement, basic agreement, and blanket purchase agreement. It is used to track the contract, and any modifications or transactions related to it. After October 2017, it is between 13 and 17 digits, both letters and numbers.
An identification code assigned to each financial assistance award tracking purposes. The FAIN is tied to that award (and all future modifications to that award) throughout the award's life. Each FAIN is assigned by an agency. Within an agency, FAIN are unique: each new award must be issued a new FAIN. FAIN stands for Federal Award Identification Number, though the digits are letters, not numbers.
The uri of the award
The amount of money the government is obligated to pay for the award
The total amount of money paid out for this award
The total of the original_loan_subsidy_cost from associated transactions
The total of the face_value_loan_guarantee from associated transactions
The date the award was signed
A description of the award
The start date for the period of performance
The current, not original, period of performance end date
The sum of the potential_value_of_award from associated transactions
The date this record was certified