Filing timeline

GET/api/filings/timeline

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.

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/timeline?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Combined filing timeline

Response schema

recent array of object
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.
array of:
- type string
  SEC form type
- accessionNumber string
  SEC accession number
- url string
  URL to the filing document
- dateFiled string
  Date the filing was submitted to the SEC (YYYY-MM-DD)
- xbrl boolean
  Whether the filing includes XBRL data
- amendment boolean
  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 array of 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 array of 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 array of 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
Predicted future filings derived from historical cadence, plus the underlying cadence pattern itself for transparency.
- nextExpected array of object
  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.
  array of:
  type string
  SEC form type
  expectedDate string (date)
  Predicted filing date (YYYY-MM-DD), snapped to a weekday.
  confidence string (enum)
  Confidence level: `high`, `medium`, or `low`.
  Allowed values: high, medium, low
  basedOn string
  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 map of string to object
  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.
  - * (additional properties) object
    typicalMonths array of integer
    Months of the year (1-12) in which the company has historically filed this form type.
    avgDaysAfterPeriodEnd integer
    Average lag in days between the filing's reporting `period_end_date` and its `date_filed`. Can be negative for forms whose `period_end_date` is in the future relative to the filing date (e.g. proxy statements scheduled for an upcoming annual meeting).
nextEarningsDate string (date) | null
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.

Example response

{
  "recent": [
    {
      "type": "144",
      "accessionNumber": "0001969223-26-000420",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/0001969223-26-000420.txt",
      "dateFiled": "2026-04-02",
      "xbrl": true,
      "amendment": false
    },
    {
      "type": "144",
      "accessionNumber": "0001959173-26-002757",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/0001959173-26-002757.txt",
      "dateFiled": "2026-04-02",
      "xbrl": true,
      "amendment": false
    },
    {
      "type": "13G",
      "accessionNumber": "0000102909-26-000630",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000010290926000630/primary_doc.xml",
      "dateFiled": "2026-03-26",
      "xbrl": true,
      "amendment": true,
      "periodEndDate": "2026-03-28"
    },
    {
      "type": "4",
      "accessionNumber": "0001780525-26-000005",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000178052526000005/wk-form4_1773786674.xml",
      "dateFiled": "2026-03-17",
      "xbrl": true,
      "amendment": false,
      "periodEndDate": "2026-03-18"
    },
    {
      "type": "3",
      "accessionNumber": "0001780525-26-000003",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000178052526000003/wk-form3_1772839848.xml",
      "dateFiled": "2026-03-06",
      "xbrl": true,
      "amendment": false,
      "periodEndDate": "2026-03-07"
    },
    {
      "type": "4",
      "accessionNumber": "0001059235-26-000004",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000105923526000004/xslF345X05/wk-form4_1772148856.xml",
      "dateFiled": "2026-02-26",
      "xbrl": false,
      "amendment": false,
      "periodEndDate": "2026-02-24"
    },
    {
      "type": "4",
      "accessionNumber": "0001179864-26-000004",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000117986426000004/xslF345X05/wk-form4_1772148791.xml",
      "dateFiled": "2026-02-26",
      "xbrl": false,
      "amendment": false,
      "periodEndDate": "2026-02-24"
    },
    {
      "type": "4",
      "accessionNumber": "0001214128-26-000004",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000121412826000004/xslF345X05/wk-form4_1772148758.xml",
      "dateFiled": "2026-02-26",
      "xbrl": false,
      "amendment": false,
      "periodEndDate": "2026-02-24"
    },
    {
      "type": "4",
      "accessionNumber": "0001051401-26-000004",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000105140126000004/xslF345X05/wk-form4_1772148721.xml",
      "dateFiled": "2026-02-26",
      "xbrl": false,
      "amendment": false,
      "periodEndDate": "2026-02-24"
    },
    {
      "type": "4",
      "accessionNumber": "0001453149-26-000005",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000145314926000005/xslF345X05/wk-form4_1772148681.xml",
      "dateFiled": "2026-02-26",
      "xbrl": false,
      "amendment": false,
      "periodEndDate": "2026-02-24"
    }
  ],
  "predicted": {
    "nextExpected": [
      {
        "type": "10-Q",
        "expectedDate": "2026-05-01",
        "confidence": "high",
        "basedOn": "earnings prediction (2026-04-30)"
      },
      {
        "type": "10-K",
        "expectedDate": "2026-11-01",
        "confidence": "high",
        "basedOn": "2025-10-31"
      },
      {
        "type": "DEF 14A",
        "expectedDate": "2027-01-09",
        "confidence": "high",
        "basedOn": "2026-01-08"
      }
    ],
    "historicalPattern": {
      "10-K": {
        "typicalMonths": [
          10,
          11
        ],
        "avgDaysAfterPeriodEnd": 34
      },
      "10-Q": {
        "typicalMonths": [
          1,
          2,
          4,
          5,
          7,
          8
        ],
        "avgDaysAfterPeriodEnd": 34
      },
      "DEF 14A": {
        "typicalMonths": [
          1
        ],
        "avgDaysAfterPeriodEnd": -51
      }
    }
  },
  "nextEarningsDate": "2026-04-30"
}

400 Bad Request

Invalid parameters

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Professional plan required

Response schema

error string
Human-readable error message

Example response

{}