# 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 on the <a href="https://twelvedata.com/pricing">Grow</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Venture</a> plan (business) and above.

## Parameters

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


- `figi` (string, optional)
  Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
  Example value: `BBG000B9Y5X2`


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


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


- `exchange` (string, optional)
  Exchange where instrument is traded
  Example value: `NASDAQ`


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


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


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


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


- `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
  Default value: `100`


- `page` (string, optional)
  Page number
  Default value: `1`



## 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=your_api_key"
```

## 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
    }
]
```