USAspending API ReferenceIndependent
Try the API

Agency Awards

GET/api/v2/agency/{toptier_code}/awards/
Powers Agency profiles on usaspending.gov How an agency profile is built

Returns the number of transactions and award obligations for a given agency and fiscal year.

Request

curl 'https://api.usaspending.gov/api/v2/agency/020/awards/'

Path parameters

  • toptier_codestringRequired

    The toptier code of an agency (could be a CGAC or FREC) so only numeric character strings of length 3-4 are accepted.

    Example 020

Query parameters

  • fiscal_yearstring

    The desired appropriations fiscal year. Defaults to the current FY.

  • agency_typeenum (string)

    This will determine if the data being returned is derived from the awarding agency or the funding agency. Defaults to awarding

    Allowed values
    • awarding
    • funding

    Default awarding

  • award_type_codesstring

    Filters the results by the provided award types. Defaults to all award types

Try it

Runs against the live API. Responses are real data.

GET/api/v2/agency/020/awards/

Response · 200

  • toptier_codestringRequired
  • fiscal_yearnumberRequired
  • latest_action_datestringRequiredNullable
  • transaction_countnumberRequired
  • obligationsnumberRequired
  • messagesarray of stringRequired

    An array of warnings or instructional directives to aid consumers of this endpoint with development and debugging.

Example response
{
  "toptier_code": "020",
  "fiscal_year": 2021,
  "latest_action_date": "2021-09-14T00:00:00",
  "transaction_count": 2,
  "obligations": 90000,
  "messages": []
}

Recent changes

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

Loading…