USAspending API ReferenceIndependent
Try the API

Agency Overview

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

Returns some basic information regarding the agency for the fiscal year specified.

Request

curl 'https://api.usaspending.gov/api/v2/agency/012/'

Path parameters

  • toptier_codestringRequired

    Example 012

Try it

Runs against the live API. Responses are real data.

GET/api/v2/agency/012/

Response · 200

  • fiscal_yearnumberRequired
  • toptier_codestringRequired
  • namestringRequired
  • abbreviationstringRequiredNullable
  • agency_idnumberRequired
  • icon_filenamestringRequiredNullable
  • missionstringRequiredNullable
  • websitestringRequiredNullable
  • congressional_justification_urlstringRequiredNullable
  • about_agency_datastringRequiredNullable
  • subtier_agency_countnumberRequired
  • def_codesarray of DEFCRequired5 fields
    • codestringRequired

      Disaster Emergency Fund Code

    • public_lawstringRequired

      Name of the public law which created the DEF or a placeholder description

    • disasterstringRequiredNullable

      Internal field to group several DEFC together for correlated relief efforts

    • titlestringRequiredNullable

      Official title of the public law or a placeholder description of the DEFC

    • urlsarray of stringRequiredNullable

      Hyperlink(s) to official documentation on the DEFC legislation

  • messagesarray of stringRequired

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

Example response
{
    "fiscal_year": 2019,
    "toptier_code": "020",
    "name": "Department of the Treasury",
    "abbreviation": "TREAS",
    "agency_id": 22,
    "icon_filename": "DOT.jpg",
    "mission": "Maintain a strong economy and create economic and job opportunities...",
    "website": "https://www.treasury.gov/",
    "congressional_justification_url": "https://www.treasury.gov/cj",
    "about_agency_data": null,
    "subtier_agency_count": 10,
    "def_codes": [
        {
            "code": "N",
            "public_law": "Emergency P.L. 116-136",
            "title": "Coronavirus Aid, Relief, and Economic Security Act or the CARES Act",
            "urls": [
                "https://www.congress.gov/116/bills/hr748/BILLS-116hr748enr.pdf"
            ],
            "disaster": "covid_19"
        }
    ]
    "messages": []
}

Recent changes

No contract changes to this endpoint since October 2024. The changelog covers every endpoint.

Contract notes

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

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

Loading…