List Company Calendar Events
Returns upcoming scheduled calendar events for a single company (earnings reports, AGMs/EGMs, dividends, and more), ordered by scheduled_at ascending. This is the same contract as GET /api/v1/calendar_events, scoped to a single company by the path.
Default window
By default only upcoming events are returned; scheduled_after/scheduled_before or updated_after lift that floor, the same way they do on the flat resource.
Plan availability
Not available on plans with a capped calendar. Use GET /api/v1/calendar_events for the upcoming-events preview instead.
Caching
Requests with updated_after are not cached: they return Cache-Control: no-cache, no-store and no ETag.
Authorizations
API Key authentication using Bearer token
Headers
ETag value from a previous response. Returns 304 Not Modified if data has not changed.
HTTP date from a previous Last-Modified header. Returns 304 Not Modified if nothing has changed since.
Path Parameters
Company ID or ticker symbol. Accepts the exchange-suffixed form (e.g. VOLV-B.ST); former tickers resolve too. When a ticker is shared by more than one company, the company with a listing on a Nordic exchange is returned, then the one with an active listing, then the most recently listed. Use the company ID for an unambiguous lookup.
Query Parameters
Number of events to return per page (default 25, max 100).
Opaque pagination cursor returned as pagination.next_cursor from a previous response. When continuing an updated_after sync, resend the same updated_after value alongside it.
Comma-separated list of fields to include in the response. Reduces payload size. id is always included. Available fields: title, description, event_type, status, date_precision, fiscal_period, scheduled_at, timezone, local_time, scheduled_at_changed_at, source_article_id, source, company_id, company, country, dividend, coverage_event, updated_at.
ISO 8601 datetime. Returns only this company's events updated after this timestamp. Use for incremental sync: store the timestamp of your last completed sync and pass it on the next request. Results are ordered by updated_at ascending and cursor-paginated. Drain pagination.next_cursor before advancing your stored timestamp. Passing this parameter also disables the default upcoming-only floor, so past events with newer updates are included.
Filter by lifecycle status. Omitted: returns scheduled + past published events and excludes cancelled. Pass cancelled to retrieve cancellations, or scheduled/published to narrow.
scheduled, published, cancelled Filter by calendar event type. Accepts a single value or a comma-separated list for multiple types. These are calendar event types (underscored) and are the only values accepted here. The hyphenated Events taxonomy slugs from GET /api/v1/event_types belong to GET /api/v1/events and are rejected. A few spellings overlap across the two vocabularies (e.g. delisting) while denoting different things: a calendar event is a dated, scheduled entry for one issuer; an Events slug classifies a narrative event that already happened.
earnings_report, earnings_call, agm, egm, dividend, capital_markets_day, trading_update, conference_presentation, ma_announcement, ma_offer_deadline, ma_completion, listing, delisting Window start. A bare date (YYYY-MM-DD) means that calendar date in each issuer's own timezone, inclusive: scheduled_after=2026-10-01&scheduled_before=2026-10-31 is October in every issuer's local calendar. An ISO 8601 datetime (Z or a UTC offset) means an exact UTC instant, at or after. Passing this parameter disables the default upcoming-only floor, allowing past events to be returned.
Window end. A bare date means that calendar date in each issuer's own timezone, inclusive. An ISO 8601 datetime means an exact UTC instant, exclusive (strictly before). Passing this parameter disables the default upcoming-only floor, allowing past events to be returned.