Sign in
latestOpenAPI 3.0.02026-08-2010141507.9 KB

3d5897270d8a

SEC Filings

Filing timeline

Pro

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/filings/timeline

Query parameters

symbolstring

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

cikinteger

SEC Central Index Key (CIK).

cusipstring

CUSIP identifier (9 characters).

composite_figistring

Composite OpenFIGI identifier.

share_class_figistring

Share-class OpenFIGI identifier.

Response

Combined filing timeline

nextEarningsDatestring 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.

Example response

{
  "recent": [
    {
      "type": "8-K",
      "accessionNumber": "0000320193-23-000106",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm",
      "dateFiled": "2023-11-02",
      "xbrl": true,
      "periodEndDate": "2023-09-30",
      "documents": [
        "g230399ex99_2p1g1.jpg",
        "g230399ex99_2p2g1.jpg"
      ],
      "title": "APPLE INC ANNUAL REPORT 2023",
      "items": [
        "1",
        "1A",
        "7",
        "7A",
        "8"
      ],
      "events": [
        "earnings",
        "financial_exhibits"
      ]
    }
  ],
  "predicted": {
    "nextExpected": [
      {
        "type": "10-Q",
        "expectedDate": "2026-05-01",
        "basedOn": "earnings prediction (2026-04-30)"
      }
    ]
  },
  "nextEarningsDate": "2026-04-30"
}