USAspending API ReferenceIndependent
Try the API

Agency Reporting Publish Dates

GET/api/v2/reporting/agencies/publish_dates/
Powers Agency submission statistics on usaspending.gov

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

Request

curl 'https://api.usaspending.gov/api/v2/reporting/agencies/publish_dates/?fiscal_year=2020'

Query parameters

  • fiscal_yearstringRequired

    The fiscal year.

    Example 2020

  • filterstring

    The agency name or abbreviation to filter on (partial match, case insesitive).

  • pagestring

    The page of results to return based on the limit.

    Default 1

  • limitstring

    The number of results to include per page.

    Default 10

  • orderenum (string)

    The direction (asc or desc) that the sort field will be sorted in.

    Allowed values
    • asc
    • desc

    Default desc

  • sortenum (string)

    A data field that will be used to sort the response array.

    Allowed values
    • agency_name
    • abbreviation
    • toptier_code
    • current_total_budget_authority_amount
    • publication_date

    Default current_total_budget_authority_amount

Try it

Runs against the live API. Responses are real data.

GET/api/v2/reporting/agencies/publish_dates/?fiscal_year=2020

Response · 200

  • page_metadataobject · PaginationMetadataRequired7 fields
    • pagenumberRequired
    • nextnumberRequiredNullable
    • previousnumberRequiredNullable
    • hasNextbooleanRequired
    • hasPreviousbooleanRequired
    • totalnumberRequired
    • limitnumberRequired
  • resultsarray of AgencyRequired5 fields
    • agency_namestringRequired
    • abbreviationstringRequired
    • toptier_codestringRequired
    • current_total_budget_authority_amountnumberRequired
    • periodsarray of PeriodRequired4 fields
      • periodnumberRequired
      • quarternumberRequired
      • submission_datesarray of SubmissionDatesRequiredNullable2 fields
        • publication_datestringRequiredNullable
        • certification_datestringRequiredNullable
      • quarterlybooleanRequired
Example response
{
  "page_metadata": {
    "page": 1,
    "next": 2,
    "previous": 0,
    "hasNext": false,
    "hasPrevious": false,
    "total": 2,
    "limit": 10
  },
  "results": [
    {
      "agency_name": "Department of Health and Human Services",
      "abbreviation": "DHHS",
      "toptier_code": "020",
      "current_total_budget_authority_amount": 8361447130497.72,
      "periods": [
        {
          "period": 2,
          "quarter": 1,
          "submission_dates": {
            "publication_date": "2020-01-20T11:59:21Z",
            "certification_date": "2020-01-21T10:58:21Z"
          },
          "quarterly": false
        }
      ]
    },
    {
      "agency_name": "Department of Treasury",
      "abbreviation": "DOT",
      "toptier_code": "021",
      "current_total_budget_authority_amount": 8361447130497.72,
      "periods": [
        {
          "period": 2,
          "quarter": 1,
          "submission_dates": {
            "publication_date": "2020-01-20T11:59:21Z",
            "certification_date": "2020-01-21T10:58:21Z"
          },
          "quarterly": false
        }
      ]
    }
  ]
}

Recent changes

Generated from contracts/v2/reporting/agencies/publish_dates.md in the USAspending API repo.

Loading…