Skip to main content
POST
POST /timeline

Use case

Get material events (SEC 8-K filings — leadership changes, M&A, financial events) for a company over a specific date range. Useful for due-diligence pulls, “what happened during this person’s tenure”-style queries, and event-driven monitoring.

Request

string
required
Company name or entity key. 2–200 characters.
string
required
Period start, YYYY-MM format.
string
Period end, YYYY-MM format. Defaults to today.
array
Filter by event type (e.g., ["8-K Item 1.01", "8-K Item 2.02"]). Empty array returns all types.

Response

object
key + name of the resolved entity.
object
start + end (echoed from request, with end filled if defaulted).
string
Human-readable summary, e.g., "2 notable events during this period".
array
Up to 20 events, ordered by filing_date DESC. Each event:
object
Placeholder for future quantitative metrics over the period.
object
Provenance — see Citation Contract.

Code samples

Live response

Item 2.02 (“Results of Operations”) filings often have null headline and description — these are routine quarterly earnings releases. For deeper inspection, follow up with the SEC filing URL or a dedicated financials data source.

Errors