Agencies Spending Disaster/Emergency Funding

POST/api/v2/disaster/agency/spending/

Powers COVID-19 spending on usaspending.gov

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

Returns spending details of Agencies receiving supplemental funding budgetary resources

Request

curl -X POST 'https://api.usaspending.gov/api/v2/disaster/agency/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",
      "A",
      "B",
      "C",
      "D",
      "IDV_A",
      "IDV_B",
      "IDV_B_A",
      "IDV_B_B",
      "IDV_B_C",
      "IDV_C",
      "IDV_D",
      "IDV_E",
      "-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
  Only to be used when "spending_type": "award".
  
  If ANY award type codes are provided, obligation and outlay spending amounts will be summed for the distinct set of toptier agencies, whose subtier agencies funded awards -- awards of the type given by award_type_codes -- linked to FinancialAccountsByAwards records (which are derived from DABS File C).
  
  If this parameter is not provided, obligation and outlay spending amounts will be summed for a different set of agencies: the distinct set of toptier agencies "owning" appropriations accounts used in funding any award spending for this disaster (i.e. from agencies "owning" Treasury Account Symbol (TAS) accounts on FinancialAccountsByAwards records, which are derived from DABS File C).
  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 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
  - total_budgetary_resources
  - obligation
  - outlay
  Default id

Try it

Runs against the live API. Responses are real data.

POST/api/v2/disaster/agency/spending/

Request body

Response · 200

totalsobject · TotalsRequired4 fields
- award_countnumber
- total_budgetary_resourcesnumber
- obligationnumberRequired
- outlaynumberRequired
resultsarray of ResultRequired8 fields
- idstringRequired
- codestringRequired
- descriptionstringRequired
- childrenarray of Result
- award_countnumberRequiredNullable
- obligationnumberRequiredNullable
- outlaynumberRequiredNullable
- total_budgetary_resourcesnumberRequiredNullable
page_metadataobject · PageMetadataRequired7 fields
- pagenumberRequired
- nextnumberRequiredNullable
- previousnumberRequiredNullable
- hasNextbooleanRequired
- hasPreviousbooleanRequired
- totalnumberRequired
- limitnumberRequired

Example response

{
  "totals": {
    "award_count": 4574,
    "obligation": 364037369840.58,
    "outlay": 290416885040.71
  },
  "results": [
    {
      "id": 168,
      "code": "349",
      "description": "District of Columbia Courts",
      "children": [],
      "award_count": null,
      "obligation": 148906061.27,
      "outlay": 143265869.34,
      "total_budgetary_resources": 18087913735.71
    },
    {
      "id": 130,
      "code": "413",
      "description": "National Council on Disability",
      "children": [],
      "award_count": null,
      "obligation": 225185.66,
      "outlay": 697329,
      "total_budgetary_resources": 183466350
    }
  ],
  "page_metadata": {
    "page": 1,
    "total": 62,
    "limit": 2,
    "next": 2,
    "previous": null,
    "hasNext": true,
    "hasPrevious": false
  }
}

Recent changes

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

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