USAspending API ReferenceIndependent
Try the API

List Budget Function

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

Returns a list of Budget Function in the Agency's appropriations for a single fiscal year

Request

curl 'https://api.usaspending.gov/api/v2/agency/086/budget_function/'

Path parameters

  • toptier_codestringRequired

    Example 086

Try it

Runs against the live API. Responses are real data.

GET/api/v2/agency/086/budget_function/

Response · 200

  • toptier_codestringRequired
  • fiscal_yearnumberRequired
  • page_metadataobject · PageMetadataRequired7 fields

    Information used for pagination of results.

    • pagenumberRequired
    • nextnumberRequiredNullable
    • previousnumberRequiredNullable
    • hasNextbooleanRequired
    • hasPreviousbooleanRequired
    • totalnumberRequired
    • limitnumberRequired
  • resultsarray of BudgetFunctionRequired4 fields
    • namestringRequired
    • obligated_amountnumberRequired
    • gross_outlay_amountnumberRequired
    • childrenarray of BudgetSubFunctionRequired3 fields
      • namestringRequired
      • obligated_amountnumberRequired
      • gross_outlay_amountnumberRequired
  • messagesarray of stringRequired

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

Example response
{
  "toptier_code": "086",
  "fiscal_year": 2018,
  "page_metadata": {
    "page": 1,
    "next": 2,
    "previous": null,
    "hasNext": true,
    "hasPrevious": false,
    "total": 1,
    "limit": 2
  },
  "results": [
    {
      "name": "Health",
      "children": [
        {
          "name": "Health care services",
          "obligated_amount": 4982.19,
          "gross_outlay_amount": 4982.19
        }
      ],
      "obligated_amount": 4982.19,
      "gross_outlay_amount": 4982.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/budget_function.md in the USAspending API repo.

Loading…