Events · US only
Financing events
- Coverage
- US (classification enums unified across markets)
- Billing
- 20 cr / thousand calls
One row = one financing event (event_class = capital): equity issuances, debt issuances, convertible notes, guarantees and defaults share one table and are distinguished by event_type. Buybacks are not on this endpoint; they belong to /events-corporate-actions.
- The type-specific fields fall into four groups: shared core (instrument, amount, counterparty, use of proceeds, closing date), debt-specific (interest rate, maturity, secured status, covenants), equity-specific (shares, price, discount, exemption, lock-up period) and convertible (conversion price / ratio, plus every debt-specific field); fields that do not apply return
null/[]. instrument/actionare the envelopeaxisflattened into top-level fields, with the same values; instrument, amount and maturity date are returned fields only, and are not filterable server-side.event_idholds the same value as on/events: once acapitalevent appears on the timeline, fetch the rows for the same date range from this endpoint to fill in the terms.
Shared events conventions
Ad hoc corporate disclosure events: financings, deals and agreements, executive changes, corporate actions, changes in major shareholder holdings, and more. Classification is not broken out by each market's regulatory forms; it is defined by "what about the company changed": the source category code is preserved as-is in source_category, and the public contract uses one canonical set of event_class / event_type (9 classes / 42 types; see OpenAPI for the full enums and each type's fields). Onboarding a new market only adds mappings; the endpoints are unchanged.
The data covers only US-listed companies: a non-US ticker returns 404; when ticker is omitted, the endpoint scans all companies on record. The six endpoints share one parameter set and one set of common envelope fields. /events is the unified timeline that carries only the common envelope; each of the five typed endpoints serves one group of event types (the last column of the table) and adds that group's own fields on top of the envelope.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | optional | Up to 10 values, comma-separated; when omitted, the endpoint scans across companies (for example "all CFO departures in the last 90 days"); combine with from / to. The market is carried by the canonical ticker itself, so there is no market parameter. Default Entire market. |
| event_type | string | optional | equity_issuance | debt_issuance | convertible | guarantee | debt_default; multiple values allowed, comma-separated. Default All. |
| 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. |
| limit | int | optional | Maximum 500. Default 50. |
| page | int | optional | Starts at 1. Default 1. |
Sorted event_date desc, accession_number desc, then row order within one filing. 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 | string | Canonical market code |
| event_class | string | Canonical enum from the table above (9 classes) |
| event_type | string | Canonical enum from the table above (42 types) |
| axis | object | Key-value object holding the secondary axis of that type (for example a profit warning, {"direction":"down"}, or a revolving credit facility, {"instrument":"revolver","action":"new"}); for a type with no axis, the value is {}. See OpenAPI for the full set of keys and value domains. Typed endpoints flatten the common axes into top-level fields (instrument / action / subtype…), with the same values as axis; on the timeline, classification detail such as the direction of a profit warning or a trading halt and resumption action is only in this field |
| 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 (signing / resolution / closing); the only date axis in this group |
| title | string | One-sentence title |
| stage | string | Lifecycle stage: announced approved amended completed terminated; the multi-stage filings of every market (proposal → shareholder meeting → approval → completion, and so on) all map onto this set |
| event_group_id | string | The successive filings of the same deal / financing / executive change share one id |
| is_current | bool | Whether the row is the latest version within the same event_group_id |
| accession_number | string | Native document number from the official source (US: SEC accession; JP: EDINET docID; CN: cninfo announcement id), or the equivalent filing number |
| form_type | string | One of the four provenance fields: the source filing type |
| filing_url | string | One of the four provenance fields: deep link to the official document |
| filing_date | date | One of the four provenance fields: the filing date |
| instrument | string | Instrument; the value domain depends on event_type: equity_issuance public_offering private_placement rights_issue pipe atm; debt_issuance bond note term_loan revolver loan; convertible cb bw exchangeable convertible_preferred (full set in OpenAPI) |
| action | string | For debt types, new / amend / drawdown / repay / cancel; for guarantee, new / release |
| amount | number | Principal / total proceeds, denominated in currency; for debt_default, the principal in default |
| currency | string | ISO 4217 |
| counterparty_names | string[] | lender / investor / underwriter; an empty array when there is no counterparty |
| use_of_proceeds | string | Use of proceeds (summarized from the filing's own wording) |
| closing_date | date | Closing / effective date |
| interest_rate | number | Coupon or initial interest rate, as a decimal rather than a percentage; null for a floating rate (the terms are in covenants) |
| maturity_date | date | Maturity date |
| is_secured | bool | Whether the instrument is secured or collateralized |
| covenants | string[] | Key covenants summarized from the filing's own wording; may be an empty array |
| shares | number | Number of shares issued |
| price_per_share | number | Issue price |
| discount_pct | number | Discount to the market price, as a decimal |
| exemption | string | Exemption relied on for the offering, in the filing's own wording and not normalized (for example Section 4(a)(2), Regulation D, Rule 144A; it may be a combined string covering several exemptions) |
| registration_rights | bool | Whether registration rights are attached (the accompanying agreement is not itself a separate event) |
| lock_up_period | string | Lock-up period, in the filing's own wording (for example 180 days) |
| conversion_price | number | Conversion price; a convertible row also carries every debt-specific field |
| conversion_ratio | number | Conversion ratio |
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.