Events · US only
Event timeline
- Coverage
- US
- Billing
- 20 cr / thousand calls
Returns a company's event timeline: financings, deals, executive changes, dividends and buybacks, ownership changes, bankruptcy and delisting. Each row contains shared fields such as the event date, classification and filing link. Type-specific fields such as deal terms are on the matching /events-* endpoint: choose it by event_class, query with the same ticker and from = to = event_date, then match on event_id (identical on both sides; typed endpoints do not accept an event_id parameter).
Response enums list only values allowed by this endpoint; each row returns one string for event_class and one for event_type. Nullable fields return null when undisclosed or inapplicable; empty arrays return [].
- Bankruptcy and delisting events (
legal_regulatory) are available only on this timeline. - Filter by category with the optional
event_classparameter; pass a comma-separated list for multiple classes, or omit it to return all classes.event_type/event_group_id/is_currentare response fields only; to filter by a specific type, use the matching typed endpoint’sevent_typeparameter. - Only the latest version,
is_current = true, is returned; the successive filings of one real-world event share anevent_group_id, which you use to group the rows within a window. - The rows of this endpoint are also the shape of the webhook company event payload.
In addition to event_class below, this endpoint accepts the shared parameters: ticker, from / to, limit / page.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | optional | Up to 10 values, comma-separated; when omitted, the endpoint scans across companies; use it with from / to. The market is carried by the canonical ticker itself, so there is no market parameter. Default: all companies. |
| from | date | optional | Start of the event date (event_date) range, inclusive; for a single day, set from = to. |
| to | date | optional | End of the event date range, inclusive. |
| event_class | stringenum | optional | Filter by event class: capital / distribution / share_structure / transaction / agreement / governance / ownership / legal_regulatory. Pass a comma-separated list for multiple classes; omit to return all classes. Default: all. |
| limit | int | optional | Maximum 500. Default: 50. |
| page | int | optional | Starts at 1. Default: 1. |
Sort order: event_date desc, accession_number desc, event_id asc. Paged with limit and page (pages start at 1); fewer rows than limit means the last page.
Response fields
| Field | Type | Description |
|---|---|---|
| event_id | string | Id of a single event; the same value on the typed endpoints and on the timeline |
| ticker | string | Canonical ticker |
| market | stringenum | Fixed value: US |
| event_class | stringenum | Event class: capital (financing) / distribution (shareholder distributions) / share_structure (share structure) / transaction (transactions) / agreement (agreements) / governance (corporate governance) / ownership (ownership changes) / legal_regulatory (bankruptcy and delisting). See event_type for the types in each class. |
| event_type | stringenum | Event types, grouped by event_class: capital = equity_issuance / debt_issuance / convertible / guarantee / debt_default; distribution = dividend / buyback / capital_reduction; share_structure = stock_split / reverse_split / bonus_issue / share_class_change; transaction = acquisition / disposal / merger / spin_off / joint_venture / strategic_investment / restructuring; agreement = license / supply / partnership / major_contract / settlement; governance = executive_change / director_change / auditor_change / equity_incentive; ownership = stake_change; legal_regulatory = delisting / bankruptcy. |
| axis | object | Secondary classifications for this event type. Only applicable, identified keys are present; returns {} when none apply. Each typed endpoint describes its keys and top-level mappings |
| source_category | string | The market's native category code, preserved as-is: for US, the 8-K item (8-K:2.03; when several items are triggered, they are joined with commas) or the 13D/G form name (SC 13D / SC 13G) |
| event_date | date | Event date, used by the from / to filters. Its meaning depends on the event type and it may differ from the filing or effective date |
| title | string | One-sentence title |
| stage | stringenum | Lifecycle stage: announced / approved / amended / completed / terminated; describes this event row, not a required sequence for every event type |
| event_group_id | string | The successive filings of the same deal / financing / executive change share one id |
| is_current | bool | Always true; historical filing versions are not returned by this endpoint |
| accession_number | string | SEC accession number |
| form_type | string | Source filing type |
| filing_url | string | Deep link to the official document |
| filing_date | date | Filing date |
No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.
Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.