Stock splits

GET/api/company/stock-splits

Returns the full history of stock splits for a single company, sourced from XBRL footnote disclosures (us-gaap:StockholdersEquityNoteStockSplitConversionRatio1 and its pre-2015 predecessor us-gaap:StockholdersEquityNoteStockSplitConversionRatio) in 10-K and 10-Q filings. Each event carries the split date, the conversion ratio, the type (forward or reverse), and provenance fields tying back to the original SEC filing.

Coverage

Forward and reverse splits since the XBRL mandate (post-2009; reliably tagged from 2011 onward).
Both types ride the same XBRL field — forwards report ratios > 1 (e.g. 4.0 for a 4-for-1), reverses report fractional ratios (e.g. 0.05 for a 1-for-20).
Roughly 2,500 distinct US companies have at least one tagged split event.
Pre-2010 splits are out of scope (predates XBRL).

Caveats

firstDisclosedAt is not the announcement date. It's when the structured XBRL fact first became available in an SEC filing. Some filers tag the split in the very next 10-Q (≈30-90 days lag); others wait until the annual 10-K (up to ~12 months). For real-time corporate-action use cases, pair with a dedicated corporate-actions feed.
date semantics vary by filer. Most filers tag the ex-date / payable date, but a minority tag the announcement date or the record date. Cross-check against an authoritative source for time-sensitive backtests.
Noop disclosures excluded. Rows with ratio = 1 (informational disclosures with no actual share-count change) are filtered out.

Results are ordered by split date descending. No pagination — even the most prolific splitter has fewer than ten events on record.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

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

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

curl 'https://api.stockfit.io/v1/api/company/stock-splits?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

List of stock split events ordered by date (most recent first). Empty array if the company has no recorded splits.

Response schema

array of:

date string (date)
The split date as tagged in the XBRL footnote (typically the ex-date or payable date; see caveats in the endpoint description). Format YYYY-MM-DD.
ratio number
The conversion ratio. For a forward split, the number of post-split shares received per pre-split share (e.g. `4` for a 4-for-1 split). For a reverse split, the fractional equivalent (e.g. `0.05` for a 1-for-20 reverse split — 20 old shares become 1 new share). To compute the post-split share count from a pre-split count: `postSplit = preSplit × ratio`.
type string (enum)
Stock split direction, derived from the split `ratio`: | Value | Meaning | |-------|---------| | `forward` | `ratio > 1`: share count increases, per-share price decreases. Typical of large-caps managing share price after a long run-up. | | `reverse` | `ratio < 1`: share count decreases, per-share price increases. Often used by small-caps to maintain exchange listing requirements (e.g. NASDAQ minimum bid price). |
Allowed values: forward, reverse
accession string
SEC accession number of the filing where this split was first disclosed in XBRL. Use this with the SEC EDGAR full-text search to retrieve the exact source filing.
firstDisclosedAt string (date)
SEC acceptance date (YYYY-MM-DD) of the filing referenced by `accession` — the earliest date this split was machine-readable from EDGAR. Note this lags the actual split date by anywhere from weeks to months depending on the filer's reporting cadence.

Example response

[
  {
    "date": "2020-08-28",
    "ratio": 4,
    "type": "forward",
    "accession": "0000320193-20-000096",
    "firstDisclosedAt": "2020-10-30"
  },
  {
    "date": "2014-06-06",
    "ratio": 7,
    "type": "forward",
    "accession": "0001193125-14-277160",
    "firstDisclosedAt": "2014-07-23"
  }
]

400 Bad Request

Invalid parameters or symbol not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}