Filing calendar

GET/api/filings/calendar

Predicts upcoming periodic filing dates (10-K, 10-Q, DEF 14A) based on historical patterns from the last 5 years. Returns expected dates with confidence levels and the historical filing pattern (typical months, average days after period end).

Confidence levels:

high — Filing dates have been very consistent (±7 days standard deviation)
medium — Some variation in filing dates (±14 days)
low — Significant variation in filing dates

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

curl 'https://api.stockfit.io/v1/api/filings/calendar?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Filing calendar with predictions

Response schema

nextExpected array of object
Predicted next filing dates, sorted chronologically
array of:
- type string
  Filing form type
- expectedDate string
  Predicted filing date (YYYY-MM-DD)
- confidence string (enum)
  Confidence level: `high`, `medium`, or `low`.
  Allowed values: high, medium, low
- basedOn string
  Most recent filing date used as the baseline (YYYY-MM-DD)
historicalPattern map of string to object
Historical filing patterns by form type
- * (additional properties) object
  - typicalMonths array of integer
    Months (1-12) when filings of this type are typically submitted
  - avgDaysAfterPeriodEnd integer
    Average number of days between period end and filing date

Example response

{
  "nextExpected": [
    {
      "type": "10-Q",
      "expectedDate": "2025-05-02",
      "confidence": {},
      "basedOn": "2025-01-31"
    }
  ],
  "historicalPattern": {
    "10-K": {
      "typicalMonths": [
        11
      ],
      "avgDaysAfterPeriodEnd": 32
    },
    "10-Q": {
      "typicalMonths": [
        2,
        5,
        8
      ],
      "avgDaysAfterPeriodEnd": 30
    }
  }
}

400 Bad Request

Invalid parameters or company not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}