Skip to main content
GET
Earnings calendar (all companies)

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).

cik
string

Numeric CIK (1–10 digits) or platform key (letters then digits, at most 10 characters): that company's dates; widens the window limit to ten years.

country
string

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

status
enum<string>

Only this status.

Available options:
estimated,
issuer_tentative,
confirmed,
elapsed,
reported,
postponed,
cancelled,
disputed

Company name or ticker contains; max 100 characters.

limit
integer
default:500

1–1000, default 500.

Required range: 1 <= x <= 1000
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[]
markets
string[]
total
integer
summary
object
offset
integer
limit
integer
generatedAt
string<date-time>