Disaster Spending By Geography

POST/api/v2/disaster/spending_by_geography/

Powers COVID-19 spending on usaspending.gov

This endpoint provides geographical spending information from emergency/disaster funding based on recipient location.

Request

curl -X POST 'https://api.usaspending.gov/api/v2/disaster/spending_by_geography/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N",
      "O",
      "P",
      "U"
    ]
  },
  "geo_layer": "state",
  "geo_layer_filters": [
    "NE",
    "WY",
    "CO",
    "IA",
    "IL",
    "MI",
    "IN",
    "TX"
  ],
  "scope": "recipient_location",
  "spending_type": "obligation"
}'

Request body

filterobject · FilterRequired2 fields
- def_codesarray of DEFCRequired
  Return an award if one of the DEF Codes match the supplied filter since an Award can have multiple DEF Codes. If the def_codes provided are in the COVID-19 group, the query will only return results of transactions where the action_date is on or after 2020-04-01.
- award_type_codesarray of AwardTypeCodes
  List of procurement and assistance award type codes supported by USAspending.gov
  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
geo_layerenum (string)Required
Set the type of shape codes in the response
Allowed values
- state
- county
- district
geo_layer_filtersarray of string
Allows us to only request data for what is currently in view in the map
scopeenum (string)
When fetching awards, use the primary place of performance or recipient location
Allowed values
- place_of_performance
- recipient_location
Default recipient_location
spending_typeenum (string)Required
Allowed values
- obligation
- outlay
- face_value_of_loan

Try it

Runs against the live API. Responses are real data.

POST/api/v2/disaster/spending_by_geography/

Request body

Response · 200

geo_layerenum (string)Required
Allowed values
- state
- county
- district
scopeenum (string)Required
When fetching transactions, use the primary place of performance or recipient location
Allowed values
- place_of_performance
- recipient_location
spending_typeenum (string)Required
Allowed values
- obligation
- outlay
- face_value_of_loan
resultsarray of GeographyTypeResult6 fields
- amountnumberRequired
  Dollar obligated or outlayed amount (depending on the spending_type requested)
- display_namestringRequired
- shape_codestringRequired
- populationnumberRequiredNullable
- per_capitanumberRequiredNullable
- award_countnumberRequired

Example response

{
  "geo_layer": "state",
  "scope": "recipient_location",
  "spending_type": "obligation",
  "results": [
    {
      "shape_code": "ND",
      "amount": 4771026.93,
      "display_name": "North Dakota",
      "population": 762062,
      "per_capita": 6.26,
      "award_count": 185
    },
    {
      "shape_code": "NV",
      "amount": 26928552.59,
      "display_name": "Nevada",
      "population": 3080156,
      "per_capita": 8.74,
      "award_count": 124
    },
    {
      "shape_code": "OH",
      "amount": 187505278.16,
      "display_name": "Ohio",
      "population": 11689100,
      "per_capita": 16.04,
      "award_count": 134
    }
  ]
}

Recent changes

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

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