USAspending API ReferenceIndependent
Try the API

Federal Account Spending Disaster/Emergency Funding

POST/api/v2/disaster/federal_account/spending/
Powers COVID-19 spending on usaspending.gov

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

Returns spending details of Federal Account and TAS receiving supplemental funding budgetary resources

Request

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"
  }
}'

Request body

  • filterobject · FilterRequired2 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.

    • 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
      • total_budgetary_resources
      • obligation
      • outlay

      Default id

Try it

Runs against the live API. Responses are real data.

POST/api/v2/disaster/federal_account/spending/

Response · 200

  • totalsobject · TotalsRequired4 fields
    • award_countnumber
    • total_budgetary_resourcesnumber
    • obligationnumberRequired
    • outlaynumberRequired
  • resultsarray of ResultRequired8 fields
    • idnumberRequired
    • 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": "43",
      "code": "090",
      "description": "Description text",
      "children": [
        {
          "id": 78470,
          "code": "020-X-1894-000",
          "description": "Air Carrier Worker Support, Departmental Offices, Department of Treasury",
          "award_count": 1,
          "obligation": 49162967964.08,
          "outlay": 34401350618.2,
          "total_budgetary_resources": null
        }
      ],
      "award_count": 54,
      "obligation": 89.01,
      "outlay": 70.98,
      "total_budgetary_resources": null
    },
    {
      "id": "41",
      "code": "012",
      "description": "Description text",
      "children": [
        {
          "id": 78461,
          "code": "020-2020/2020-1892-000",
          "description": "Coronavirus Relief Fund, Departmental Offices, Treasury",
          "award_count": 1,
          "obligation": 293266617784.74,
          "outlay": 293266617784.74,
          "total_budgetary_resources": null
        }
      ],
      "award_count": 2,
      "obligation": 50,
      "outlay": 10,
      "total_budgetary_resources": null
    }
  ],
  "page_metadata": {
    "page": 1,
    "total": 915,
    "limit": 2,
    "next": 2,
    "previous": null,
    "hasNext": true,
    "hasPrevious": false
  }
}

Recent changes

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

Loading…