Events · US only
Financing events
GET/api/v2/events-financingsUS only
- Coverage
- US
- Billing
- 20 cr / thousand calls
Returns a company's financing events with their terms: equity issuances, debt issuances, convertible notes, guarantees and defaults, one row per event (event_class = capital), distinguished by event_type, with amount, interest rate, maturity, issue price and other terms in type-specific fields. Buybacks are not here; they belong to /events-corporate-actions.
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 [].
- 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.
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_type | stringenum | optional | equity_issuance | debt_issuance | convertible | guarantee | debt_default; multiple values allowed, comma-separated. 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 | Fixed value: capital |
| event_type | stringenum | equity_issuance | debt_issuance | convertible | guarantee | debt_default |
| axis | object | Financing classifications, for example {"instrument":"revolver","action":"new"}. Identified instrument / action values match the top-level fields; missing keys are omitted and no classifications returns {} |
| source_category | string | SEC 8-K item, preserved as filed; multiple triggering items are comma-separated, for example 8-K:1.01,2.03 |
| event_date | date | Financing event date, falling back to filing_date when absent from the filing. Filters use this field, not closing_date or maturity_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 |
| instrument | string | nullenum | 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 | nullenum | For debt types, new / amend / drawdown / repay / cancel; for guarantee, new / release |
| amount | number | null | Principal / total proceeds, denominated in currency; for debt_default, the principal in default |
| currency | string | null | ISO 4217 |
| counterparty_names | string[] | lender / investor / underwriter; an empty array when there is no counterparty |
| use_of_proceeds | string | null | Use of proceeds (summarized from the filing's own wording) |
| closing_date | date | null | Closing / effective date |
| interest_rate | number | null | 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 | null | Maturity date |
| is_secured | bool | null | 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 | null | Number of shares issued |
| price_per_share | number | null | Issue price |
| discount_pct | number | null | Discount to the market price, as a decimal |
| exemption | string | null | 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 | null | Whether registration rights are attached (the accompanying agreement is not itself a separate event) |
| lock_up_period | string | null | Lock-up period, in the filing's own wording (for example 180 days) |
| conversion_price | number | null | Conversion price; a convertible row also carries every debt-specific field |
| conversion_ratio | number | null | 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.