Docs/Reference/Filings/Filing Calendar
GET/v1/filings/calendarTier · Free

Filing Calendar

Filing calendar: companies with period_end in the given month.

Useful for knowing which companies' annual reports are expected. Returns companies grouped by their fiscal year end date.

Query parameters · 1

Optional filters and modifiers. Pass as URL-encoded ?key=value.

monthstringrequired

Month in YYYY-MM format (e.g. 2025-06)

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains an array of CalendarEntry.

Envelope

dataCalendarEntry[]

Array of result objects.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

CalendarEntry

datestring

Date in ISO 8601 format (YYYY-MM-DD).

filing_countinteger

Number of filings received on this date.

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.