# Splits calendar

The splits calendar endpoint provides a detailed calendar of stock split events within a specified date range. By setting the `start_date` and `end_date` parameters, users can retrieve a list of upcoming or past stock splits, including the company name, split ratio, and effective date. This endpoint is useful for tracking changes in stock structure and planning investment strategies around these events.

**API credits cost:** `40` per symbol

> **Note:** This API endpoint is available starting with the [Grow](https://twelvedata.com/pricing) plan.

## Parameters

- `symbol` (string, optional)
  Symbol ticker of instrument. For preffered stocks use dot(.) delimiter.
E.g. `BRK.A` or `BRK.B` will be correct


- `figi` (string, optional)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


- `isin` (string, optional)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `exchange` (string, optional)
  Exchange where instrument is traded


- `mic_code` (string, optional)
  Market Identifier Code (MIC) under ISO 10383 standard


- `country` (string, optional)
  Country where instrument is traded, e.g., `United States` or `US`


- `start_date` (string, optional)
  The starting date (inclusive) for filtering split events in the calendar. Format `2006-01-02`


- `end_date` (string, optional)
  The ending date (inclusive) for filtering split events in the calendar. Format `2006-01-02`


- `outputsize` (integer, optional)
  Number of data points to retrieve. Supports values in the range from `1` to `500`. Default `100` when no date parameters are set, otherwise set to maximum


- `page` (string, optional)
  Page number



## Response

- `` (array of object)
  - `date` (string)
    Stands for the split date
  - `symbol` (string)
    Ticker of the company
  - `mic_code` (string)
    Market Identifier Code (MIC) under ISO 10383 standard
  - `exchange` (string)
    Exchange name where the company is listed
  - `description` (string)
    Specification of the split event
  - `ratio` (number)
    The ratio by which the number of a company's outstanding shares of stock are increased following a stock split. For example, a `4-for-1 split` results in four times as many outstanding shares, with each share selling at one forth of its pre-split price
  - `from_factor` (number)
    From factor of the split
  - `to_factor` (number)
    To factor of the split


## Example Request

```bash
curl "https://api.twelvedata.com/splits_calendar?apikey=demo"
```

## Example Response

```json
[
    {
        "date": "1987-06-16",
        "symbol": "AAPL",
        "mic_code": "XNGS",
        "exchange": "NASDAQ",
        "description": "2-for-1 split",
        "ratio": 0.5,
        "from_factor": 2,
        "to_factor": 1
    }
]
```