USAspending API ReferenceIndependent
Try the API

Federal Obligations

GET/api/v2/federal_obligations/
Powers Federal account profiles on usaspending.gov

This endpoint is 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 the amount that the specific agency has obligated to various federal accounts in a given fiscal year.

Request

curl 'https://api.usaspending.gov/api/v2/federal_obligations/?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

  • limitstring

    The maximum number of results to return in the response.

    Example 10

  • pagestring

    The response page to return (the record offset is (page - 1) * limit).

    Example 1

Try it

Runs against the live API. Responses are real data.

GET/api/v2/federal_obligations/?fiscal_year=2017&funding_agency_id=456&limit=10&page=1

Response · 200

  • resultsarray of FederalAccountRequired4 fields
    • account_titlestringRequired
    • account_numberstringRequired
    • idstringRequired

      The USAspending.gov unique identifier for the federal account. You will need to use this ID when making API requests for details about specific federal accounts.

    • obligated_amountstringRequired
  • page_metadataobject · PageMetadataObjectRequired7 fields
    • countnumberRequired
    • pagenumberRequired
    • has_next_pagebooleanRequired
    • has_previous_pagebooleanRequired
    • nextstringRequiredNullable
    • currentstringRequired
    • previousstringRequiredNullable
Example response
{
  "results": [
    {
      "account_title": "",
      "account_number": "",
      "id": "",
      "obligated_amount": ""
    }
  ],
  "page_metadata": {
    "count": 0,
    "page": 0,
    "has_next_page": false,
    "has_previous_page": false,
    "next": null,
    "current": "",
    "previous": null
  }
}

Recent changes

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

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

Loading…