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

# Upcoming stock splits

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

## Request

- Base URL: `https://api.stockfit.io/v1`
- URL: `https://api.stockfit.io/v1/api/company/upcoming-stock-splits`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/stockfit/apis/stockfit-api/docs/api/company/upcoming-stock-splits/get.ts> (a function with typed inputs; its response is checked against the schema)

![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

## Changes

- **2026-08-14** `2e1930f62a5d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stockfit/apis/stockfit-api/changes/api/company/upcoming-stock-splits/get.md)

---

[API](https://skmtc.dev/stockfit/apis/stockfit-api.md) - [All operations](https://skmtc.dev/stockfit/apis/stockfit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stockfit/apis/stockfit-api/revisions/ade8e65563c3?raw)