Events

Get Event

Fetches a single event by ID.

A merged or removed event returns 200 with the minimal tombstone shape (see the list endpoint's description) rather than 404. The id still resolves; it carries no content. An event with no live member articles at all returns 404. An event whose live members exist but are all outside your plan's age/source restrictions returns 403 with an upgrade problem, distinct from the plain 404.

Responses are cached with ETag and Cache-Control: private, max-age=300; send If-None-Match to receive a 304 Not Modified. There is no Last-Modified here, for the same reason as GET /api/v1/events.

get/api/v1/events/{id}

Request

Query parameters

include_peripheralboolean

When true, company_ids and companies[] also include companies with a peripheral role (advisor, speaker, or a passing mention). Default false lists companies with an active-involvement role only (subject, acquirer, target, investor, issuer, partner). association_tier is present on every companies[] entry regardless.

Headers

If-None-Matchstring

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

Response

Event retrieved

Example response

{
  "event": {
    "id": "k3n8vdczq1mp",
    "title": "Volvo AB announces Q3 2026 results",
    "status": "active",
    "significance": "notable",
    "event_type": {
      "slug": "earnings-report",
      "label": "Earnings Report",
      "category": "earnings"
    },
    "article_count": 3,
    "first_reported_at": "2026-10-22T05:00:00.000Z",
    "last_article_at": "2026-10-23T09:15:00.000Z",
    "updated_at": "2026-10-23T09:20:00.000Z",
    "company_ids": [
      "uejazctgchj4"
    ],
    "story_ids": [
      "8fzq2rmtnk5c"
    ],
    "merged_into": "v3xdq8fmz1kn",
    "related_to": "v3xdq8fmz1kn",
    "summary": "Volvo AB reported Q3 2026 results, beating analyst expectations on strong truck demand...",
    "article_ids": [
      "h4mzq918kxwc",
      "q2fnk75dxzmv"
    ],
    "primary_disclosure_article_id": "h4mzq918kxwc",
    "figure_divergence": {
      "groups": [
        {
          "concept": "operating_profit",
          "basis": "reported",
          "role": "actual",
          "period": "2026-Q1",
          "currency": "SEK",
          "labels": [
            "Rörelseresultatet"
          ],
          "min": 313000000,
          "max": 395000000,
          "values": [
            {
              "id": "h4mzq918kxwc",
              "source": "MFN",
              "normalized_value": 395000000,
              "value": "395 MSEK"
            }
          ]
        }
      ]
    },
    "companies": [
      {
        "id": "uejazctgchj4",
        "name": "AB Volvo (Volvo Group)",
        "ticker": "VOLV-B",
        "is_primary": true,
        "association_tier": "principal"
      }
    ]
  }
}

Changes

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