USAspending API ReferenceIndependent
Try the API

List Federal Accounts

POST/api/v2/awards/accounts/
Powers Award summaries on usaspending.gov How an award summary is built

This endpoint returns a list of federal accounts under a given award.

Request

curl -X POST 'https://api.usaspending.gov/api/v2/awards/accounts/' \
  -H 'Content-Type: application/json' \
  -d '{
  "limit": 10,
  "sort": "total_transaction_obligated_amount",
  "order": "desc",
  "award_id": "CONT_AWD_N0001917C0001_9700_-NONE-_-NONE-",
  "page": 1
}'

Request body

  • award_idstringRequired

    Award to return accounts for

  • pagenumber

    Page number to return

  • limitnumber

    Maximum number to return

  • orderenum (string)

    Direction of sort

    Allowed values
    • asc
    • desc

    Default desc

  • sortenum (string)

    The field to sort on

    Allowed values
    • account_title
    • agency
    • federal_account
    • total_transaction_obligated_amount

    Default federal_account

Try it

Runs against the live API. Responses are real data.

POST/api/v2/awards/accounts/

Response · 200

  • resultsarray of AccountListingRequired8 fields
    • total_transaction_obligated_amountnumberRequired
    • federal_accountstringRequired
    • account_titlestringRequired
    • funding_agency_abbreviationstringRequiredNullable
    • funding_agency_namestringRequiredNullable
    • funding_agency_idnumberRequiredNullable
    • funding_toptier_agency_idnumberRequiredNullable
    • funding_agency_slugstringRequiredNullable
  • page_metadataobject · PageMetadataRequired6 fields
    • pagenumberRequired
    • nextnumberRequiredNullable
    • countnumberRequired
    • previousnumberRequiredNullable
    • hasNextbooleanRequired
    • hasPreviousbooleanRequired
Example response
{
  "results": [
    {
      "total_transaction_obligated_amount": 1234.56,
      "federal_account": "075-1301",
      "account_title": "Bureau of Consumer Financial Protection Fund",
      "funding_agency_abbreviation": "NIH",
      "funding_agency_name": "National Institutes of Health",
      "funding_agency_id": 123,
      "funding_toptier_agency_id": 45,
      "funding_agency_slug": "national-institutes-of-health"
    }
  ],
  "page_metadata": {
    "page": 1,
    "next": 2,
    "count": 4,
    "previous": 1,
    "hasNext": true,
    "hasPrevious": false
  }
}

Recent changes

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

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

Loading…