USAspending API ReferenceIndependent
Try the API

Disaster Spending Overview

GET/api/v2/disaster/overview/
Powers COVID-19 spending on usaspending.gov

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

Request

curl 'https://api.usaspending.gov/api/v2/disaster/overview/'

Query parameters

  • def_codesstring

    Comma-delimited list of DEF codes to limit results to.

Try it

Runs against the live API. Responses are real data.

GET/api/v2/disaster/overview/

Response · 200

  • fundingarray of FundingRequired2 fields
    • def_codestringRequired

      DEF Code providing the source funding

    • amountnumberRequired

      Aggregation amount under the DEFC

  • total_budget_authoritynumberRequired
  • spendingobject · SpendingRequired4 fields
    • award_obligationsnumberRequiredNullable

      Amount of Disaster Spending which has been awarded and obligated. Note: total_obligations - award_obligations = "Other Obligations"

    • award_outlaysnumberRequiredNullable

      Amount of Disaster Spending which has been awarded, obligated, and outlayed. Note: award_obligations - award_outlays = "Award Obligated But Not Yet Outlayed"

    • total_obligationsnumberRequiredNullable

      Total amount of Disaster Spending which has been obligated. Note: total_budget_authority - total_obligations = "Remaining Balance"

    • total_outlaysnumberRequiredNullable

      Total amount of Disaster Spending which has been obligated and outlayed. Note: (total_obligations - award_obligations) - (total_outlays - award_outlays) = "Other Obligated But Not Yet Outlayed"

  • additionalobject · Additional

    Special cases where financial details were not labeled with the searched DEFC, but they should be considered in the overview

    • total_budget_authority (required, number)

    • spending (object)

      • total_obligations (required, number, nullable) Total amount of Disaster Spending which has been obligated.
      • total_outlays (required, number, nullable) Total amount of Disaster Spending which has been obligated and outlayed.
Example response
{
  "funding": [
    {
      "def_code": "L",
      "amount": 7410000000
    },
    {
      "def_code": "M",
      "amount": 11230000000
    }
  ],
  "total_budget_authority": 2300000000000,
  "spending": {
    "award_obligations": 866700000000,
    "award_outlays": 413100000000,
    "total_obligations": 963000000000,
    "total_outlays": 459000000000
  },
  "additional": {
    "spending": {
      "total_obligations": 45600000,
      "total_outlays": 12300000
    },
    "total_budget_authority": 789000000
  }
}

Recent changes

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

Loading…