Object Classes Spending Disaster/Emergency Funding

POST/api/v2/disaster/object_class/spending/

Powers COVID-19 spending on usaspending.gov

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

Returns spending details of Object Classes receiving supplemental funding budgetary resources

Request

curl -X POST 'https://api.usaspending.gov/api/v2/disaster/object_class/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
  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/object_class/spending/

Request body

Response · 200

totalsobject · TotalsRequired3 fields
- award_countnumber
- obligationnumberRequired
- outlaynumberRequired
resultsarray of ResultRequired7 fields
- idstringRequired
- codestringRequired
- descriptionstringRequired
- childrenarray of Result
- award_countnumberRequiredNullable
- obligationnumberRequiredNullable
- outlaynumberRequiredNullable
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": "90",
      "code": "90",
      "description": "Other",
      "award_count": 5,
      "obligation": 746085355.77,
      "outlay": 723027742.93,
      "children": [
        {
          "id": "195",
          "code": "920",
          "description": "Undistributed",
          "award_count": 1,
          "obligation": 20077899.96,
          "out`lay": 13711575.76
        }
      ]
    },
    {
      "id": "40",
      "code": "40",
      "description": "Grants and fixed charges",
      "award_count": 8,
      "obligation": 595026834439.96,
      "outlay": 569289818857.45,
      "children": []
    }
  ],
  "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
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/object_class/spending.md in the USAspending API repo.