Skip to main content
GET
Corporate events calendar

Authorizations

X-API-KEY
string
header
default:pk_live_YOUR_KEY
required

Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....

Query Parameters

from
string

First day, YYYY-MM-DD (default today).

to
string

Last day, YYYY-MM-DD (default from).

kinds
string

Comma-separated: meeting, leadership, dividend, capital, listing, other.

country
string

Uppercase ISO alpha-2 market codes, comma-separated, up to 80 (e.g. AE,SA). Lowercase codes answer 400.

Company name, ticker or CIK contains (also matches company-name search aliases); max 100 characters. Event text is not searched.

limit
integer

Page size, 1–500 (500 when only offset is given); with offset, pages the window (nextOffset names the next page). Without both, the whole window.

Required range: 1 <= x <= 500
offset
integer
default:0

Rows to skip, default 0.

Required range: x >= 0
view
enum<string>
default:full

compact drops display-only fields (logos, websites).

Available options:
full,
compact

Response

OK

Inferred from captured responses: every field shown was returned by a real call; a field may be absent or null on other calls.

from
string<date>
to
string<date>
events
object[]
total
integer
summary
object
truncated
boolean
generatedAt
string<date-time>
offset
integer
limit
integer
nextOffset
integer