USAspending API ReferenceIndependent
Try the API

Agency Overview

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

These endpoints are used to power USAspending.gov's agency profile pages. This data can be used to better understand the different ways that a specific agency spends money.

This endpoint returns a high-level overview of a specific government agency, given its USAspending.gov id.

Request

curl 'https://api.usaspending.gov/api/v2/references/agency/456/'

Path parameters

  • idstringRequired

    The unique USAspending.gov agency identifier. This ID is the agency_id value returned in the /api/v2/references/toptier_agencies/ endpoint.

    Example 456

Try it

Runs against the live API. Responses are real data.

GET/api/v2/references/agency/456/

Response · 200

  • resultsobjectRequired11 fields
    • active_fystringRequired

      The fiscal year that the data in the response reflects.

    • active_fqstringRequired

      The latest quarter of the active_fy that the data in the response reflects.

    • agency_namestringRequired
    • missionstringRequired

      The agency's mission statement.

    • icon_filenamestringRequired

      The file name of the agency's logo. If no logo is available, this will be an empty string. Images can be found at https://www.usaspending.gov/graphics/agency/[file].

    • websitestringRequired
    • congressional_justification_urlstringRequiredNullable
    • budget_authority_amountstringRequired
    • current_total_budget_authority_amountstringRequired
    • obligated_amountstringRequired
    • outlay_amountstringRequired
Example response
{
  "results": {
    "agency_name": "Department of Health and Human Services",
    "active_fy": "2020",
    "active_fq": "1",
    "outlay_amount": "436376232652.87",
    "obligated_amount": "452507150028.76",
    "budget_authority_amount": "1958993691342.83",
    "current_total_budget_authority_amount": "8361447130497.72",
    "mission": "It is the mission of the U.S. Department of Health & Human Services (HHS) to enhance and protect the health and well-being of all Americans. We fulfill that mission by providing for effective health and human services and fostering advances in medicine, public health, and social services.",
    "website": "https://www.hhs.gov/",
    "icon_filename": "DHHS.jpg",
    "congressional_justification_url": "https://www.hhs.gov/cj"
  }
}

Recent changes

Generated from contracts/v2/references/agency/id.md in the USAspending API repo.

Loading…