USAspending API ReferenceIndependent
Try the API

Federal Accounts Landing Page

GET/api/v2/federal_accounts/{account_number}/
Powers Federal account profiles on usaspending.gov

This endpoint supports the federal account landing page, which provides a list of all federal accounts for which individual federal accounts pages are available on USAspending.gov.

This endpoint returns the agency identifier, account code, title, and database id for the given federal account.

Request

curl 'https://api.usaspending.gov/api/v2/federal_accounts/011/'

Path parameters

  • account_numberstringRequired

    1022 (required, string) The Federal Account symbol comprised of Agency Code and Main Account Code. A unique identifier for federal accounts.

    Example 011

Query parameters

  • fiscal_yearstring

    Example 2022

Try it

Runs against the live API. Responses are real data.

GET/api/v2/federal_accounts/011/?fiscal_year=2022

Response · 200

  • fiscal_yearnumberRequired

    Example 2022

  • idnumberRequired

    Example 3356

  • agency_identifierstringRequired

    Example 011

  • main_account_codestringRequired

    Example 1022

  • federal_account_codestring

    1022 (required, string)

    Example 011

  • account_titlestringRequired

    Example International Narcotics Control and Law Enforcement, International Security Assistance, State

  • parent_agency_toptier_codestringRequired

    Example 019

  • parent_agency_namestringRequired

    Example Department of State

  • bureau_namestringRequired

    Example Interest on the Public Debt

  • bureau_slugstring

    on-the-public-debt (required, string)

    Example interest

  • total_obligated_amountnumber

    Sum of all child Treasury Account obligated_amount values or null if there are no child Treasury Accounts.

    Example -31604.5

  • total_gross_outlay_amountnumber

    Sum of all child Treasury Account gross_outlay_amount values or null if there are no child Treasury Accounts.

    Example 7643425.94

  • total_budgetary_resourcesnumber

    Sum of all child Treasury Account budgetary_resources_amount values or null if there are no child Treasury Accounts.

    Example 54653496.23

  • childrenarray of TreasuryAccountRequired5 fields

    List of applicable Treasury Accounts for the given Federal Account and fiscal year. Otherwise, it will be an empty array.

    • namestringRequired
    • codestringRequired
    • obligated_amountnumberRequired
    • gross_outlay_amountnumberRequired
    • budgetary_resources_amountnumberRequired
Example response
{
    "fiscal_year": "2022",
    "id": 3356,
    "agency_identifier": "011",
    "main_account_code": "1022",
    "account_title": "International Narcotics Control and Law Enforcement, International Security Assistance, State",
    "federal_account_code": "011-1022",
    "parent_agency_toptier_code": "019",
    "parent_agency_name": "Department of State",
    "bureau_name": "Interest on the Public Debt",
    "bureau_slug": "interest-on-the-public-debt",
    "total_obligated_amount": -31604.5,
    "total_gross_outlay_amount": 7643425.94,
    "total_budgetary_resources": 54653496.23,
    "children": [
        {
            "name": "International Narcotics Control and Law Enforcement, International Security Assistance, State",
            "code": "019-011-2012/2017-1022-000",
            "obligated_amount": -5497.39,
            "gross_outlay_amount": 4463819.02,
            "budgetary_resources_amount": 48917689.28
        },
        {
            "name": "International Narcotics Control and Law Enforcement, International Security Assistance, State",
            "code": "019-011-2013/2018-1022-000",
            "obligated_amount": -26107.11,
            "gross_outlay_amount": 3179606.92,
            "budgetary_resources_amount": 5735806.95
        },
    ]
}

Recent changes

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

Generated from contracts/v2/federal_accounts/account_number.md in the USAspending API repo.

Loading…