Skip to main content

Dividends: Upcoming & History

Dividends

Returns a list of dividend events, including upcoming and historical records.
Each entry contains dividend amount, yield, key dates, and company identifiers.

Use this endpoint to build dividend calendars, estimate yields, or analyze historical payments.

API Reference

Method Path Description
GET /v2/dividends Retrieve upcoming or historical dividend events

Query parameters

Key Type Default Description
limit integer 30 Maximum number of results to return (up to 100)
offset integer 0 Number of records to skip before returning results
sort_by string — Field to sort results by (e.g. year, div_percent)
sort_order string ASC Sort direction: ASC or DESC
updated_in_days integer — Return only entries updated in the last N days
mode string upcoming Filter by dividend type: upcoming or past

Model Structure

Field Type Description
changed_at string (ISO) Last update timestamp
code string Company ticker (e.g. GAZP)
div_amount number Dividend amount per share
div_curr string Currency of the dividend (e.g. RUB)
div_percent number Dividend yield as a percentage
exchange string Exchange code (e.g. MOEX)
last_buy_date string (date) Last day to buy shares with dividend eligibility
last_buy_price number Closing price on the last buy date
link string (URL) Source or official announcement link
reestr_close_date string (date) Registry close date (record date)
type string Dividend type (e.g. interim, final, special)
year integer Year for which the dividend is declared

Use Case 1: Upcoming Dividends

Scenario

A client wants to show investors a calendar of upcoming dividends with the highest expected yield.

Request

GET /v2/dividends?mode=upcoming&sort_by=div_percent&sort_order=DESC&token=<YOUR_API_TOKEN>

Response

[
  {
    "code": "GAZP",
    "div_amount": 52.53,
    "div_curr": "RUB",
    "div_percent": 12.4,
    "exchange": "MOEX",
    "last_buy_date": "2025-07-15",
    "last_buy_price": 424.50,
    "link": "https://example.com/dividends/GAZP",
    "reestr_close_date": "2025-07-16",
    "type": "final",
    "year": 2024,
    "changed_at": "2025-06-25T16:20:29.461Z"
  },
  ...
]

Use Case 2: Historical Dividends

Scenario

A client wants to analyze past dividend payouts across all companies without filtering by ticker.

Request

GET /v2/dividends?mode=past&token=<YOUR_API_TOKEN>

Response

[
  {
    "code": "SBER",
    "div_amount": 27.47,
    "div_curr": "RUB",
    "div_percent": 10.1,
    "exchange": "MOEX",
    "last_buy_date": "2024-07-18",
    "last_buy_price": 271.00,
    "link": "https://example.com/dividends/SBER",
    "reestr_close_date": "2024-07-19",
    "type": "final",
    "year": 2023,
    "changed_at": "2024-08-01T09:00:00.000Z"
  },
  {
    "code": "GAZP",
    "div_amount": 52.53,
    "div_curr": "RUB",
    "div_percent": 12.4,
    "exchange": "MOEX",
    "last_buy_date": "2024-07-15",
    "last_buy_price": 424.50,
    "link": "https://example.com/dividends/GAZP",
    "reestr_close_date": "2024-07-16",
    "type": "final",
    "year": 2023,
    "changed_at": "2024-08-02T12:00:00.000Z"
  },
  ...
]

Get Your Trial Access

To use this endpoint, you need an API token.

We provide demo access within 1 business day — just contact us at api@cisfundamentals.com with a brief description of your use case.

Want to integrate CIS market data into your product, research, or internal systems? We're happy to help — just reach out.

Request Access