USAspending API ReferenceIndependent
Try the API

IDV Download

POST/api/v2/download/idv/
Powers Custom award and account data on usaspending.gov How the Download Center works

Creates a new download job for the requested award and returns a link to a zipped file containing IDV data

Request

curl -X POST 'https://api.usaspending.gov/api/v2/download/idv/' \
  -H 'Content-Type: application/json' \
  -d '{
  "award_id": "CONT_IDV_BBGBPA08452513_9568"
}'

Request body

  • award_idstringRequired

    Example CONT_IDV_BBGBPA08452513_9568

  • file_formatenum (string)

    The format of the file(s) in the zip file containing the data.

    Allowed values
    • csv
    • tsv
    • pstxt

    Default csv

Try it

Runs against the live API. Responses are real data.

POST/api/v2/download/idv/

Response · 200

  • status_urlstringRequired

    The endpoint used to get the status of a download.

  • file_namestringRequired

    Is the name of the zipfile containing CSVs that will be generated (file_name is timestamp followed by _transactions or _awards).

  • file_urlstringRequired

    The URL for the file.

  • download_requestobjectRequired

    The JSON object used when processing the download.

Example response
{
  "status_url": "http://localhost:8000/api/v2/download/status?file_name=CONT_BBGBPA08452513_2020-01-13_H21M09S13110251.zip",
  "file_name": "CONT_BBGBPA08452513_2020-01-13_H21M09S13110251.zip",
  "file_url": "/csv_downloads/CONT_BBGBPA08452513_2020-01-13_H21M09S13110251.zip",
  "download_request": {
    "account_level": "treasury_account",
    "award_id": 68835500,
    "columns": [],
    "download_types": [
      "contract_federal_account_funding",
      "contract_transactions",
      "sub_contracts"
    ],
    "file_format": "csv",
    "filters": {
      "award_id": 68835500,
      "award_type_codes": [
        "B",
        "C",
        "A",
        "D"
      ]
    },
    "include_data_dictionary": true,
    "include_file_description": {
      "destination": "ContractAwardSummary_download_readme.txt",
      "source": "/usaspending-api/usaspending_api/data/ContractSummary_download_readme.txt"
    },
    "is_for_assistance": false,
    "is_for_contract": true,
    "is_for_idv": false,
    "limit": 500000,
    "piid": "BBGBPA08452513",
    "request_type": "contract"
  }
}

Recent changes

Generated from contracts/v2/download/idv.md in the USAspending API repo.

Loading…