USAspending API ReferenceIndependent
Try the API

Award data archive

Prepackaged monthly files and bulk award downloads.

POST3GET1Open on usaspending.gov How the Download Center works

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

POSTBulk Award Download/api/v2/bulk_download/awards/

This endpoint is used by the Custom Award Data Download page.

filterscolumnsfile_format
curl -X POST 'https://api.usaspending.gov/api/v2/bulk_download/awards/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "prime_award_types": [
      "A",
      "B",
      "C",
      "D",
      "IDV_A",
      "IDV_B",
      "IDV_B_A",
      "IDV_B_B",
      "IDV_B_C",
      "IDV_C",
      "IDV_D",
      "IDV_E",
      "02",
      "03",
      "04",
      "05",
      "10",
      "06",
      "07",
      "08",
      "09",
      "11",
      "-1"
    ],
    "date_type": "action_date",
    "date_range": {
      "start_date": "2019-10-01",
      "end_date": "2020-09-30"
    },
    "agencies": [
      {
        "type": "funding",
        "tier": "subtier",
        "name": "Animal and Plant Health Inspection Service",
        "toptier_name": "Department of Agriculture"
      }
    ]
  },
  "file_format": "csv"
}'
Full reference and live console Contract
POSTList Agencies/api/v2/bulk_download/list_agencies/

This route returns one of three result set flavors.

typeagency
curl -X POST 'https://api.usaspending.gov/api/v2/bulk_download/list_agencies/' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "award_agencies",
  "agency": 0
}'
Full reference and live console Contract
POSTList Monthly Files/api/v2/bulk_download/list_monthly_files/

Returns a list of the current versions of generated archive files for a given fiscal year and agency.

agencyfiscal_yeartype
curl -X POST 'https://api.usaspending.gov/api/v2/bulk_download/list_monthly_files/' \
  -H 'Content-Type: application/json' \
  -d '{
  "agency": 50,
  "fiscal_year": 2018,
  "type": "assistance"
}'
Full reference and live console Contract
GETBulk Download Status/api/v2/bulk_download/status

This route gets the current status of a download job.

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

Loading…