NOnordicfinancialnews
Companies

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.

get/api/v1/companies/{identifier}/calendar_events

Request

  • Base URL
    https://nordicfinancialnews.com
  • Auth
    HTTP bearer

Query parameters

limitinteger

Number of events to return per page (default 25, max 100).

cursorstring

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.

fieldsstring

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.

updated_afterstring

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.

status'scheduled' | 'published' | 'cancelled'

Filter by lifecycle status. Omitted: returns scheduled + past published events and excludes cancelled. Pass cancelled to retrieve cancellations, or scheduled/published to narrow.

event_type'earnings_report' | 'earnings_call' | 'agm' | 'egm' | 'dividend' | 'capital_markets_day' | 'trading_update' | 'conference_presentation' | 'ma_announcement' | 'ma_offer_deadline' | 'ma_completion' | 'listing' | 'delisting'

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.

scheduled_afterstring

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.

scheduled_beforestring

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.

Headers

If-None-Matchstring

ETag value from a previous response. Returns 304 Not Modified if data has not changed.

If-Modified-Sincestring

HTTP date from a previous Last-Modified header. Returns 304 Not Modified if nothing has changed since.

Response

Company calendar events retrieved successfully

Example response

{
  "calendar_events": [
    {
      "id": "cale_q3volvo1",
      "title": "Q3 2026 Interim Report",
      "description": "Publication of the interim report for Q3 2026 and earnings call at 10:00 CET.",
      "event_type": "earnings_report",
      "status": "scheduled",
      "date_precision": "day",
      "fiscal_period": "q3_2026",
      "scheduled_at": "2026-10-22T05:00:00.000Z",
      "timezone": "Europe/Stockholm",
      "local_time": "2026-10-22T07:00:00.000+02:00",
      "scheduled_at_changed_at": "2026-03-15T10:00:00.000Z",
      "source_article_id": "art_xyz45678",
      "source": {
        "type": "article",
        "name": "Cision",
        "article_id": "art_xyz45678"
      },
      "company_id": "w55fcw3pbg3p",
      "company": {
        "id": "w55fcw3pbg3p",
        "name": "Telefonaktiebolaget LM Ericsson",
        "ticker": "ERIC-B"
      },
      "country": "SE",
      "dividend": {
        "ex_date": "2026-04-25",
        "record_date": "2026-04-28",
        "payment_date": "2026-05-06",
        "declaration_date": "2026-03-20",
        "kind": "ordinary"
      },
      "coverage_event": {
        "id": "p2hmwsev8sp9",
        "title": "Ericsson Q3 2026 Earnings Report",
        "significance": "notable",
        "url": "https://nordicfinancialnews.com/events/p2hmwsev8sp9"
      },
      "updated_at": "2026-03-01T09:00:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.