Assistance Listings (CFDA) Data Dictionary¶
This document describes the fields available in the Assistance Listings API endpoints (/api/assistance_listings/). For filtering, ordering, and pagination, see the Assistance Listings API Reference.
Overview¶
Assistance listings are CFDA (Catalog of Federal Domestic Assistance) program codes used for federal grants and assistance. Each listing has a number (e.g., "84.027") and title. This is reference data, not the assistance transactions endpoint. Data is sourced from USAspending reference files.
Note: This endpoint supports response shaping via the shape query parameter. On list requests, the default shape is number,title. Detail responses use the full serializer when no ?shape= is provided.
Update Frequency¶
Assistance listing reference data is updated when USAspending CFDA reference data is refreshed (periodic).
Fields¶
| Field | Type | Description | Source |
|---|---|---|---|
number | String | CFDA program number (primary key; digits and dots, e.g., "84.027"). | USAspending |
title | String | Program title. | USAspending |
popular_name | String | Popular or common name, when available. | USAspending |
objectives | Text | Program objectives. | USAspending |
applicant_eligibility | Text | Applicant eligibility description. | USAspending |
benefit_eligibility | Text | Benefit eligibility description. | USAspending |
published_date | Date | Date published. | USAspending |
archived_date | Date | Date archived, when applicable. | USAspending |
Data Sources¶
- USAspending – CFDA reference data (e.g., cfda.csv).
Usage Notes¶
- Use
numberfor lookups. Detail at/api/assistance_listings/{number}/(number supports digits and.). This endpoint is for the reference list only; for assistance transactions use the assistance/awards endpoints; see Assistance Listings API Reference.