---
title: "Filing timeline"
method: GET
path: "/api/filings/timeline"
tags: ["SEC Filings"]
---

# Filing timeline

`GET /api/filings/timeline`

![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Compressed research endpoint: returns the 10 most recent filings, predicted future filing dates with confidence levels, and the predicted next earnings call date in a single call. Replaces three separate API calls (filings search + filings calendar + earnings calendar).

The 10-Q / 10-K entry in `predicted.nextExpected` is anchored on the same earnings prediction returned via `nextEarningsDate`, so the filing date and earnings date are internally consistent (e.g. 10-Q is filed ~1 day after the earnings call). Other recurring filing types (DEF 14A, ARS, etc.) are projected from historical filing intervals.

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string

## Response `200`

Combined filing timeline

- object
  - `recent` FilingInfo[], required — The 10 most recent filings for the symbol, newest first. Each entry follows the standard `FilingInfo` shape — fields that don't apply to the form type (e.g. `periodEndDate` on Form 4, `items` on a 10-K) are omitted rather than null.
    - `type` string, required — SEC form type
    - `accessionNumber` string, required — SEC accession number
    - `url` string, required — URL to the filing document
    - `dateFiled` string, required — Date the filing was submitted to the SEC (YYYY-MM-DD)
    - `xbrl` boolean, required — Whether the filing includes XBRL data
    - `amendment` boolean, required — Whether this filing is an amendment
    - `periodEndDate` string — Period end date for the report (YYYY-MM-DD). Omitted for filings without a reporting period (Form 144, 4, etc).
    - `documents` string[] — Ordered list of slide/exhibit filenames (images >= 50KB). To get the full URL, replace the filename in the filing `url` with the document filename. Omitted when no extractable documents are present.
    - `title` string — Descriptive title of the filing. Omitted when the filing has no meaningful title.
    - `items` string[] — Extracted item identifiers. For 10-K/10-Q: section numbers (e.g. "1A", "7"). For 8-K: SEC item codes (e.g. "2.02", "9.01"). For S-1: section keys (e.g. "risk-factors"). Omitted when no items are extracted. Use `/api/filings/item` to retrieve the full content of any listed item.
    - `events` string[] — Developer-friendly event type names for 8-K filings. Omitted for non-8-K filings. See the `event` parameter for the full enum.
  - `predicted` object, required — Predicted future filings derived from historical cadence, plus the underlying cadence pattern itself for transparency.
    - `nextExpected` object[], required — One entry per recurring filing type expected next. Sorted by `expectedDate` ascending. Includes 10-Q, 10-K, and any other periodic forms with at least 2 historical filings.
      - `type` string, required — SEC form type
      - `expectedDate` string, date, required — Predicted filing date (YYYY-MM-DD), snapped to a weekday.
      - `confidence` 'high' | 'medium' | 'low', required — Confidence level: `high`, `medium`, or `low`.
      - `basedOn` string, required — Source of the prediction. For 10-Q / 10-K this is the literal string `earnings prediction (YYYY-MM-DD)` referencing the earnings call this filing is grounded on. For other types it is the most recent prior filing date (YYYY-MM-DD) used as the cadence anchor.
    - `historicalPattern` object, required — Per-form-type cadence summary. Keyed by SEC form type. Useful for understanding why the prediction was made and how stable the company's filing schedule is.
  - `nextEarningsDate` string, date, nullable, required — Predicted next earnings call date (YYYY-MM-DD), or `null` when no prior earnings 8-K exists. Same value as `/api/earnings/calendar` returns. The 10-Q / 10-K entry in `predicted.nextExpected` is grounded on this date, typically ±1 day for 10-Q and ±6-8 days for 10-K.

## Other responses

- `400` — Invalid parameters
- `403` — Professional plan required

---

[API](https://skmtc.net/stockfit/apis/stockfit-api.md) · [All operations](https://skmtc.net/stockfit/apis/stockfit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockfit/stockfit-api/revisions/3d5897270d8a/schema)