---
title: "Upcoming stock splits"
method: GET
path: "/api/company/upcoming-stock-splits"
tags: ["Company"]
---

# Upcoming stock splits

`GET /api/company/upcoming-stock-splits`

![Stock](https://img.shields.io/badge/Stock-f97316) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Declared stock splits executing in the next N days (default 7, max 28), sorted by split date ascending. Covers common stocks with an active listing; fund and ETF splits are not included. Each entry is one declared split event with the execution date, the conversion ratio, and the direction.

This is the forward-looking complement to the two historical split endpoints: `/api/company/stock-splits` and `/api/company/recent-stock-splits` are sourced from XBRL filing disclosures and lag the event by weeks to months, while this calendar lists splits the company has announced but not yet executed. `ratio` uses the same semantics in all three, so the feeds join cleanly.

## Query parameters

- `days` integer
- `page` integer
- `pageSize` integer

## Response `200`

Paginated list of upcoming split events.

- object
  - `page` integer — Current page number (1-indexed).
  - `pageSize` integer — Number of results per page.
  - `totalPages` integer — Total number of pages.
  - `totalResults` integer — Total split events in the window.
  - `data` object[]
    - `symbols` string[] — All active tickers for the entity, primary first. A multi-class issuer is a single entry with all classes.
    - `name` string — Issuer name (SEC conformed form).
    - `splitDate` string — Split execution date (YYYY-MM-DD). Shares trade on the new basis from this date.
    - `ratio` number, nullable — The conversion ratio, same semantics as the historical split endpoints. `> 1` for forward splits (e.g. `10` = 10-for-1), `< 1` for reverse splits (e.g. `0.05` = 1-for-20). Compute the post-split share count as `preSplit x ratio`. Null when the declared ratio text could not be parsed numerically; see `ratioText`.
    - `ratioText` string, nullable — The ratio exactly as declared in the calendar (e.g. `"10 : 1"`). Present even when `ratio` is null.
    - `type` 'forward' | 'reverse', nullable — Split direction derived from `ratio`. Null when `ratio` is null.

## Other responses

- `400` — Invalid parameters
- `403` — Feature not available on current plan

---

[API](https://skmtc.net/stockfit/apis/stockfit-api.md) · [All operations](https://skmtc.net/stockfit/apis/stockfit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockfit/stockfit-api/revisions/3d5897270d8a/schema)