Upcoming events
Returns a list of upcoming events for public companies — such as financial reports, dividend dates, and other corporate actions.
Each entry includes event description, company ticker, date, exchange, and optional link to source.
Use this endpoint to build an investment calendar or integrate event alerts into your workflow.
API Reference
| Method | Path | Description |
|---|---|---|
GET |
/v2/calendar |
Retrieve a list of upcoming company 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. date, code) |
sort_order |
string | ASC |
Sort direction: ASC or DESC |
Model Structure
| Field | Type | Description |
|---|---|---|
category |
string | Type of event (e.g. financials, dividend, AGM) |
code |
string | Company ticker (e.g. GAZP) |
date |
string (date) | Event date (format: YYYY-MM-DD) |
event |
string | Description of the event |
exchange |
string | Exchange code (e.g. MOEX) |
link |
string (URL) | Source or official announcement link |
month |
integer | Numeric month (1–12) |
period |
string | Reporting or dividend period (e.g. Q1, H1, FY) |
type |
string | Report type (e.g. IFRS, RSBU, dividend) |
year |
integer | Calendar year for the event |
Use Case
Scenario
A client wants to display the nearest corporate events in chronological order.
Request
GET /v2/calendar?&token=<YOUR_API_TOKEN>
Response
[
{
"category": "financials",
"code": "GAZP",
"date": "2025-07-25",
"event": "Q2 2025 IFRS report",
"exchange": "MOEX",
"link": "https://example.com/calendar/GAZP",
"month": 7,
"period": "Q2",
"type": "IFRS",
"year": 2025
},
...
]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.