USAspending API ReferenceIndependent
Try the API

List Monthly Files

POST/api/v2/bulk_download/list_monthly_files/
Powers Award data archive on usaspending.gov How the Download Center works

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

Request

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

Request body

  • agencynumberRequired
  • fiscal_yearnumberRequired
  • typeenum (string)
    Allowed values
    • assistance
    • contracts

Try it

Runs against the live API. Responses are real data.

POST/api/v2/bulk_download/list_monthly_files/

Response · 200

  • monthly_filesarray of MonthlyFileRequired7 fields
    • agency_namestringRequired
    • agency_acronymstringRequiredNullable
    • file_namestringRequired
    • fiscal_yearnumberRequired
    • typeenum (string)Required
      Allowed values
      • assistance
      • contracts
    • updated_datestringRequired
    • urlstringRequired
Example response
{
  "monthly_files": [
    {
      "agency_name": "",
      "agency_acronym": null,
      "file_name": "",
      "fiscal_year": 0,
      "type": "assistance",
      "updated_date": "",
      "url": ""
    }
  ]
}

Recent changes

Generated from contracts/v2/bulk_download/list_monthly_files.md in the USAspending API repo.

Loading…