USAspending API ReferenceIndependent
Try the API

COVID-19 spending

Disaster and emergency funding by agency, program, recipient, and place.

POST19GET2Open on usaspending.gov

Open a row for parameters and ready-to-run samples. The full reference has every field and a live console.

POSTCount of Agencies Receiving Disaster/Emergency Funding/api/v2/disaster/agency/count/

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

filter
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/agency/count/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N"
    ]
  }
}'
Full reference and live console Contract
POSTAgencies Spending Disaster/Emergency Funding via Loans/api/v2/disaster/agency/loans/

This endpoint provides insights on the Agencies awarding loans from disaster/emergency funding per the requested filters.

filterpagination
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/agency/loans/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N",
      "O",
      "P",
      "U"
    ],
    "award_type_codes": [
      "07",
      "08"
    ]
  },
  "pagination": {
    "limit": 10,
    "page": 1,
    "sort": "award_count",
    "order": "desc"
  },
  "spending_type": "total"
}'
Full reference and live console Contract
POSTAgencies Spending Disaster/Emergency Funding/api/v2/disaster/agency/spending/

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

filterspending_typepagination
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"
}'
Full reference and live console Contract
POSTAggregated Award Spending From Disaster/Emergency Funding/api/v2/disaster/award/amount/

This endpoint provides account data obligation and outlay spending aggregations of all (File D) Awards which received disaster/emergency funding per the requested filters.

filter
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/award/amount/' \
  -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"
}'
Full reference and live console Contract
POSTCount of Awards Receiving Disaster/Emergency Funding/api/v2/disaster/award/count/

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

filter
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/award/count/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N"
    ]
  }
}'
Full reference and live console Contract
POSTCount of CFDA Receiving Disaster/Emergency Funding/api/v2/disaster/cfda/count/

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

filter
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/cfda/count/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N"
    ]
  }
}'
Full reference and live console Contract
POSTCFDA Programs Spending Disaster/Emergency Funding via Loans/api/v2/disaster/cfda/loans/

This endpoint provides insights on the CFDA Programs' loans from disaster/emergency funding per the requested filters.

filterpagination
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/cfda/loans/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N",
      "O",
      "P",
      "U"
    ],
    "award_type_codes": [
      "07",
      "08"
    ]
  },
  "pagination": {
    "limit": 10,
    "page": 1,
    "sort": "award_count",
    "order": "desc"
  },
  "spending_type": "total"
}'
Full reference and live console Contract
POSTCFDA Programs Spending Disaster/Emergency Funding/api/v2/disaster/cfda/spending/

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

filterspending_typepagination
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"
}'
Full reference and live console Contract
POSTCount of DEF Codes Receiving Disaster/Emergency Funding/api/v2/disaster/def_code/count/

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

filter
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/def_code/count/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N"
    ]
  }
}'
Full reference and live console Contract
POSTCount of Federal Accounts Receiving Disaster/Emergency Funding/api/v2/disaster/federal_account/count/

This endpoint provides the count of Federal Accounts and TAS which received disaster/emergency funding per the requested filters.

filter
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/federal_account/count/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N"
    ]
  }
}'
Full reference and live console Contract
POSTFederal Account Spending Disaster/Emergency Funding via Loans/api/v2/disaster/federal_account/loans/

This endpoint provides insights on the Federal Accounts awarding loans from disaster/emergency funding per the requested filters.

filterpagination
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/federal_account/loans/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N",
      "O",
      "P",
      "U"
    ]
  },
  "pagination": {
    "limit": 10,
    "page": 1,
    "sort": "award_count",
    "order": "desc"
  },
  "spending_type": "total"
}'
Full reference and live console Contract
POSTFederal Account Spending Disaster/Emergency Funding/api/v2/disaster/federal_account/spending/

This endpoint provides insights on the Federal Account and TAS which received disaster/emergency funding per the requested filters.

filterspending_typepagination
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/federal_account/spending/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N",
      "O",
      "P",
      "U"
    ]
  },
  "spending_type": "total",
  "pagination": {
    "page": 1,
    "limit": 2,
    "order": "desc",
    "sort": "id"
  }
}'
Full reference and live console Contract
POSTCount of Object Classes Receiving Disaster/Emergency Funding/api/v2/disaster/object_class/count/

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

filter
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/object_class/count/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N"
    ]
  }
}'
Full reference and live console Contract
POSTAgencies Spending Disaster/Emergency Funding via Loans/api/v2/disaster/object_class/loans/

This endpoint provides insights on the Object Classes' loans from disaster/emergency funding per the requested filters.

filterpagination
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/object_class/loans/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N",
      "O",
      "P",
      "U"
    ]
  },
  "pagination": {
    "limit": 10,
    "page": 1,
    "sort": "award_count",
    "order": "desc"
  },
  "spending_type": "total"
}'
Full reference and live console Contract
POSTObject Classes Spending Disaster/Emergency Funding/api/v2/disaster/object_class/spending/

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

filterspending_typepagination
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"
}'
Full reference and live console Contract
GETDisaster Spending Overview/api/v2/disaster/overview/

This endpoint provides funding and spending details from emergency/disaster supplemental funding legislation.

?def_codes
curl 'https://api.usaspending.gov/api/v2/disaster/overview/'
Full reference and live console Contract
POSTCount of Recipients Receiving Disaster/Emergency Funding/api/v2/disaster/recipient/count/

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

filter
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"
    ]
  }
}'
Full reference and live console Contract
POSTRecipient Spending Disaster/Emergency Funding via Loans/api/v2/disaster/recipient/loans/

This endpoint provides insights on the recipient loans from disaster/emergency funding per the requested filters.

filterpagination
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/recipient/loans/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter": {
    "def_codes": [
      "L",
      "M",
      "N",
      "O",
      "P",
      "U"
    ],
    "award_type_codes": [
      "07",
      "08"
    ]
  },
  "pagination": {
    "limit": 10,
    "page": 1,
    "sort": "award_count",
    "order": "desc"
  },
  "spending_type": "total"
}'
Full reference and live console Contract
POSTRecipient Spending Disaster/Emergency Funding/api/v2/disaster/recipient/spending/

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

filterpagination
curl -X POST 'https://api.usaspending.gov/api/v2/disaster/recipient/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"
}'
Full reference and live console Contract
POSTDisaster Spending By Geography/api/v2/disaster/spending_by_geography/

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

filtergeo_layergeo_layer_filtersscopespending_type
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"
}'
Full reference and live console Contract
GETDEF Code Types/api/v2/references/def_codes/

This endpoint returns a JSON object describing all Disaster and Emergency Funding (DEF) Codes

curl 'https://api.usaspending.gov/api/v2/references/def_codes/'
Full reference and live console Contract

Loading…