CFDA Programs Spending Disaster/Emergency Funding

POST/api/v2/disaster/cfda/spending/

Powers COVID-19 spending on usaspending.gov

This endpoint provides insights on the CFDA Programs which received disaster/emergency funding per the requested filters.

Returns spending details of CFDA receiving supplemental funding budgetary resources

Request

curl -X POST 'https://api.usaspending.gov/api/v2/disaster/cfda/spending/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N",
      "O",
      "P",
      "U"
    ],
    "award_type_codes": [
      "02",
      "03",
      "04",
      "05",
      "07",
      "08",
      "10",
      "06",
      "09",
      "11",
      "-1"
    ]
  },
  "pagination": {
    "limit": 10,
    "page": 1,
    "sort": "award_count",
    "order": "desc"
  },
  "spending_type": "total"
}'

Request body

filterobject · FilterRequired3 fields
- def_codesarray of DEFCRequired
  List of Disaster Emergency Fund (DEF) Codes (DEFC) defined by legislation at the time of writing. When filtering on award_type_codes this will filter on File D records that have at least one File C with the provided DEFC and belong to CARES Act DEFC. A list of current DEFC can be found here.
- award_type_codesarray of AwardTypeCodes
  Defaults to all Award Type Codes. Applicable only when requested award spending.
  Allowed values
  - 02
  - 03
  - 04
  - 05
  - 06
  - 07
  - 08
  - 09
  - 10
  - 11
  - A
  - B
  - C
  - D
  - IDV_A
  - IDV_B_A
  - IDV_B_B
  - IDV_B_C
  - IDV_B
  - IDV_C
  - IDV_D
  - IDV_E
  - -1
  - F001
  - F002
  - F003
  - F004
  - F005
  - F006
  - F007
  - F008
  - F009
  - F010
- querystring
  A "keyword" or "search term" to filter down results based on this text snippet
spending_typeenum (string)Required
Toggle if the outlay and obligation response values are total or only from awards
Allowed values
- total
- award
paginationobject · Pagination4 fields
- pagenumber
  Requested page of results
  Default 1
- limitnumber
  Page Size of results
  Default 10
- orderenum (string)
  Indicates what direction results should be sorted by. Valid options include asc for ascending order or desc for descending order.
  Allowed values
  - desc
  - asc
  Default desc
- sortenum (string)
  Optional parameter indicating what value results should be sorted by
  Allowed values
  - id
  - code
  - description
  - award_count
  - obligation
  - outlay
  Default id

Try it

Runs against the live API. Responses are real data.

POST/api/v2/disaster/cfda/spending/

Request body

Response · 200

totalsobject · TotalsRequired3 fields
- award_countnumberRequired
- obligationnumberRequired
- outlaynumberRequired
resultsarray of ResultRequired12 fields
- idstringRequired
- codestringRequired
- descriptionstringRequired
- award_countnumberRequired
- obligationnumberRequiredNullable
- outlaynumberRequiredNullable
- resource_linkstringRequiredNullable
  Link to an external website with more information about this result.
- cfda_federal_agencystringRequired
- cfda_objectivesstringRequired
- cfda_websitestringRequiredNullable
  Link to an external website with more information about this program.
- applicant_eligibilitystringRequired
- beneficiary_eligibilitystringRequired
page_metadataobject · PageMetadataRequired7 fields
- pagenumberRequired
- nextnumberRequiredNullable
- previousnumberRequiredNullable
- hasNextbooleanRequired
- hasPreviousbooleanRequired
- totalnumberRequired
- limitnumberRequired

Example response

{
  "totals": {
    "award_count": 4574,
    "obligation": 364037369840.58,
    "outlay": 290416885040.71
  },
  "results": [
    {
      "code": "20.200",
      "award_count": 1,
      "description": "CFDA 2",
      "id": 200,
      "obligation": 20,
      "outlay": 0,
      "resource_link": "www.example.com/200",
      "cfda_federal_agency": "OFFICE OF FEDERAL STUDENT AID, EDUCATION, DEPARTMENT OF",
      "cfda_objectives": "To provide loan capital directly from the Federal government",
      "cfda_website": "http://www.ifap.ed.gov/.",
      "applicant_eligibility": "The applicant must be a U.S. citizen, national, or",
      "beneficiary_eligibility": "Vocational, undergraduate, and graduate"
    },
    {
      "code": "10.100",
      "award_count": 1,
      "description": "CFDA 1",
      "id": 100,
      "obligation": 2,
      "outlay": 0,
      "resource_link": null,
      "cfda_federal_agency": "OFFICE OF FEDERAL STUDENT AID, EDUCATION, DEPARTMENT OF",
      "cfda_objectives": "To provide loan capital directly from the Federal government",
      "cfda_website": "http://www.ifap.ed.gov/.",
      "applicant_eligibility": "The applicant must be a U.S. citizen, national, or",
      "beneficiary_eligibility": "Vocational, undergraduate, and graduate"
    }
  ],
  "page_metadata": {
    "page": 1,
    "next": 2,
    "previous": null,
    "hasNext": true,
    "hasPrevious": false,
    "total": 23,
    "limit": 2
  }
}

Recent changes

June 17, 2026DEV-15240: Update API contracts with new Assistance Type codes
September 21, 2020Mentioned in the September 21, 2020 release notes
August 7, 2020Mentioned in the August 07, 2020 release notes

Generated from contracts/v2/disaster/cfda/spending.md in the USAspending API repo.