USAspending API ReferenceIndependent
Try the API

Agencies Reporting Publish Dates History

GET/api/v2/reporting/agencies/{toptier_code}/{fiscal_year}/{fiscal_period}/submission_history/
Powers Agency submission statistics on usaspending.gov

This endpoint is used to power USAspending.gov's About the Data | Agencies submission history modal.

This endpoint returns the history of publication and certification dates for a single agency's submission.

Request

curl 'https://api.usaspending.gov/api/v2/reporting/agencies/020/2020/10/submission_history/'

Path parameters

  • toptier_codestringRequired

    The specific agency's toptier code.

    Example 020

  • fiscal_yearstringRequired

    The fiscal year of the submission

    Example 2020

  • fiscal_periodstringRequired

    The fiscal period of the submission. valid values: 2-12 (2 = November ... 12 = September) For retriving quarterly submissions, provide the period which equals 'quarter * 3' (e.g. Q2 = P6)

    Example 10

Try it

Runs against the live API. Responses are real data.

GET/api/v2/reporting/agencies/020/2020/10/submission_history/

Response · 200

  • resultsarray of SubmissionHistoryRequired2 fields
    • publication_datestringRequiredNullable
    • certification_datestringRequiredNullable
Example response
{
  "results": [
    {
      "publication_date": "2020-10-11T11:59:21Z",
      "certification_date": "2020-10-22T11:59:21Z"
    },
    {
      "publication_date": "2020-07-10T11:59:21Z",
      "certification_date": "2020-07-11T11:59:21Z"
    },
    {
      "publication_date": "2020-07-10T11:59:21Z",
      "certification_date": null
    }
  ]
}

Recent changes

Generated from contracts/v2/reporting/agencies/toptier_code/fiscal_year/fiscal_period/submission_history.md in the USAspending API repo.

Loading…