Agency Profile

GET/api/v2/financial_balances/agencies/

Powers Federal account profiles on usaspending.gov

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 aggregated balances for a specific government agency in a given fiscal year.

Request

curl 'https://api.usaspending.gov/api/v2/financial_balances/agencies/?fiscal_year=2017&funding_agency_id=456'

Query parameters

fiscal_yearstringRequired
The fiscal year that you are querying data for.
Example 2017
funding_agency_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/financial_balances/agencies/?fiscal_year=2017&funding_agency_id=456

fiscal_year query, required

funding_agency_id query, required

Response · 200

resultsarray of FinancialBalanceRequired3 fields
- budget_authority_amountstringRequired
  Example 1899160740172.16
- obligated_amountstringRequired
  Example 524341511584.82
- outlay_amountstringRequired
  Example 523146830716.62

Example response

{
  "results": [
    {
      "budget_authority_amount": "1899160740172.16",
      "obligated_amount": "524341511584.82",
      "outlay_amount": "523146830716.62"
    }
  ]
}

Recent changes

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

Generated from contracts/v2/financial_balances/agencies.md in the USAspending API repo.