Assistance Listing

GET/api/v2/references/assistance_listing/{code}

Powers Reference data on usaspending.gov

This endpoint returns a list of Tier 1 Assistance Listings which is the code (first two numbers of CFDA code), the count of Tier 2 children, and the Tier 2 children. Tier 2 includes the full CFDA code and description.

Request

curl 'https://api.usaspending.gov/api/v2/references/assistance_listing/11'

Path parameters

codestringRequired
Example 11

Try it

Runs against the live API. Responses are real data.

GET/api/v2/references/assistance_listing/11

code path, required

Response · 200

resultsarray of AssistanceListingObjectRequired4 fields
- codestringRequired
- descriptionstringRequired
- countnumber
- childrenarray of AssistanceListingObject

Example response

[
  {
    "code": "98",
    "description": null,
    "count": 12
  },
  {
    "code": "97",
    "description": null,
    "count": 147
  },
  {
    "code": "96",
    "description": null,
    "count": 12
  },
  {
    "code": "95",
    "description": null,
    "count": 9
  }
]

Recent changes

October 31, 2025DEV-13688: Update api contract
October 28, 2025DEV-13694: Consolidate PaginationMixin to common/helper directory
October 24, 2025DEV-13694: Update api contract
October 21, 2025Mentioned in the October 21, 2025 release notes
October 7, 2025DEV-13329: Update to only show children when a code is provided

Contract notes

The contract doesn't declare code in its URL template, so it was added here from the path.

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