Count of Recipients Receiving Disaster/Emergency Funding

POST/api/v2/disaster/recipient/count/

Powers COVID-19 spending on usaspending.gov

This endpoint provides the count of Recipients which received disaster/emergency funding per the requested filters.

This endpoint returns a count of Recipients

Request

curl -X POST 'https://api.usaspending.gov/api/v2/disaster/recipient/count/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N",
      "O",
      "P",
      "U"
    ]
  }
}'

Request body

filterobject · FilterRequired2 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.
  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
  - F001
  - F002
  - F003
  - F004
  - F005
  - F006
  - F007
  - F008
  - F009
  - F010

Try it

Runs against the live API. Responses are real data.

POST/api/v2/disaster/recipient/count/

Request body

Response · 200

countnumberRequired

Example response

{
  "count": 5
}

Recent changes

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

Generated from contracts/v2/disaster/recipient/count.md in the USAspending API repo.