USAspending API ReferenceIndependent
Try the API

DABS Submission Window Dates

GET/api/v2/references/submission_periods/
Powers Agency profiles on usaspending.gov How an agency profile is built

This endpoint provides a list of all fields in the "dabs_submission_window_schedule" table except 'id'.

Request

curl 'https://api.usaspending.gov/api/v2/references/submission_periods/'

Query parameters

  • use_cachestring

    Whether or not to use a cache when retrieving values. Defaults to false.

    Example false

Try it

Runs against the live API. Responses are real data.

GET/api/v2/references/submission_periods/?use_cache=false

Response · 200

  • available_periodsarray of AvailablePeriodRequired10 fields
    • period_start_datestringRequired

      Period start date for submission

    • period_end_datestringRequired

      Period end date for submission

    • submission_start_datestringRequired

      Submission window start date

    • submission_due_datestringRequired

      Submission window due/end date

    • certification_due_datestringRequired

      Certification due date

    • submission_reveal_datestringRequired

      Submission reveal date, submission data must be revealed after this date

    • submission_fiscal_yearnumberRequired

      Fiscal year for submission

    • submission_fiscal_quarternumberRequired

      Fiscal quarter for submission

    • submission_fiscal_monthnumberRequired

      Fiscal month/period for submission

    • is_quarterbooleanRequired

      Boolean to identify if record is a monthly or quarterly submission

Example response
{
  "available_periods": [
    {
      "period_start_date": "2016-10-01T00:00:00Z",
      "period_end_date": "2016-12-31T00:00:00Z",
      "submission_start_date": "2017-01-19T00:00:00Z",
      "submission_due_date": "2017-02-19T00:00:00Z",
      "certification_due_date": "2017-02-19T00:00:00Z",
      "submission_reveal_date": "2017-02-20T00:00:00Z",
      "submission_fiscal_year": 2017,
      "submission_fiscal_quarter": 1,
      "submission_fiscal_month": 3,
      "is_quarter": true
    },
    {
      "period_start_date": "2017-01-01T00:00:00Z",
      "period_end_date": "2017-03-31T00:00:00Z",
      "submission_start_date": "2017-04-19T00:00:00Z",
      "submissison_due_date": "2017-05-19T00:00:00Z",
      "certification_due_date": "2017-05-19T00:00:00Z",
      "submission_reveal_date": "2017-05-20T00:00:00Z",
      "submission_fiscal_year": 2017,
      "submission_fiscal_quarter": 2,
      "submission_fiscal_month": 6,
      "is_quarter": true
    }
  ]
}

Recent changes

No contract changes to this endpoint since October 2024. The changelog covers every endpoint.

Generated from contracts/v2/references/submission_periods.md in the USAspending API repo.

Loading…