---
title: "Corporate Actions Calendar"
method: GET
path: "/v2/corporate-actions/"
tags: ["News & Filings"]
---

# Corporate Actions Calendar

`GET /v2/corporate-actions/`

## Request

- Base URL: `https://api.sectors.app`
- URL: `https://api.sectors.app/v2/corporate-actions/`
- Auth: API key in header `Authorization`

Corporate actions across every IDX ticker in a date window, grouped by type: the market-wide counterpart of the per-symbol [Corporate Actions](https://docs.sectors.app/api-references/v2/indonesia/company/corporate-actions) endpoint. Row keys match the per-symbol endpoint. `start`/`end` filter (and sort) each type on one key: `dividend`, `upcoming_dividend`, `bonus` and `right_issue` on `ex_date`, `stock_split` on `date` (its ex-date), `warrant` on `trading_period_start`, and `agm` on `agm_date`; ties sort by `symbol`.

<Note>`end` may be in the future, so the window works as a calendar. Default window: today - 30 days to today + 30 days. Wider ranges are clamped to the 90 days ending at `end`.</Note>

<Note>Only the requested `type` keys are present in the response.</Note>

<Info>Costs 1 API credit per requested type. Default (all 7 types) consumes 7 credits.</Info>

## Query parameters

- `start` string
- `end` string
- `type` string[]

## Response `200`

Requested action types, each a list of rows sorted by date then symbol.

- CorporateActionsCalendarResponse
  - `start` string, date, required
  - `end` string, date, required
  - `dividend` CorporateActionsDividendRow[]
    - `symbol` string, required
    - `ex_date` string, date, required: Ex-date.
    - `cum_date` string, date, nullable, required
    - `recording_date` string, date, nullable, required
    - `payment_date` string, date, nullable, required
    - `dividend_amount` number, double, nullable, required
    - `dividend_yield` number, double, nullable, required
  - `upcoming_dividend` CorporateActionsUpcomingDividendRow[]
    - `symbol` string, required
    - `ex_date` string, date, required: Ex-date.
    - `cum_date` string, date, nullable, required
    - `recording_date` string, date, nullable, required
    - `payment_date` string, date, nullable, required
    - `dividend_amount` number, double, nullable, required
  - `stock_split` CorporateActionsStockSplitRow[]
    - `symbol` string, required
    - `date` string, date, required: Ex-date.
    - `cum_date` string, date, nullable, required
    - `recording_date` string, date, nullable, required
    - `split_ratio` number, double, nullable, required
    - `ratio` string, nullable, required: E.g. `1:2`.
  - `bonus` CorporateActionsBonusRow[]
    - `symbol` string, required
    - `ex_date` string, date, required: Ex-date.
    - `cum_date` string, date, nullable, required
    - `recording_date` string, date, nullable, required
    - `payment_date` string, date, nullable, required
    - `old_ratio` number, double, nullable, required
    - `new_ratio` number, double, nullable, required
  - `right_issue` CorporateActionsRightIssueRow[]
    - `symbol` string, required
    - `ex_date` string, date, required: Ex-date.
    - `cum_date` string, date, nullable, required
    - `recording_date` string, date, nullable, required
    - `trading_period_start` string, date, nullable, required
    - `trading_period_end` string, date, nullable, required
    - `subscription_date` string, date, nullable, required
    - `price` number, double, nullable, required
    - `old_ratio` number, double, nullable, required
    - `new_ratio` number, double, nullable, required
  - `warrant` CorporateActionsWarrantRow[]
    - `symbol` string, required
    - `trading_period_start` string, date, required: First trading day of the warrant.
    - `trading_period_end` string, date, nullable, required
    - `ex_per_start` string, date, nullable, required
    - `ex_per_end` string, date, nullable, required
    - `maturity_date` string, date, nullable, required
    - `price` number, double, nullable, required
    - `ratio_warrant` number, double, nullable, required
    - `ratio_shares` number, double, nullable, required
  - `agm` CorporateActionsAgmRow[]
    - `symbol` string, required
    - `agm_date` string, date, required: Meeting date.
    - `recording_date` string, date, nullable, required
    - `agm_time` string, time, nullable, required
    - `agm_place` string, nullable, required

## Other responses

- `400`: Unknown type, invalid date, or start after end.
- `429`: Rate limit exceeded.

## Changes

- **2026-11-03** `88c3e55f60fc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sectors/apis/sectors-api/changes/v2/corporate-actions/get.md)

---

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