Stories

Get Story Details

Returns the full details of a single story, including content in Markdown format, associated articles, and companies. Supports conditional requests via If-None-Match for efficient caching.

get/api/v1/stories/{id}

Request

Path parameters

idstring required

Story ID (e.g. sty_abc123def).

Headers

If-None-Matchstring

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

Response

Story found

Example response

{
  "story": {
    "id": "story_volvo_q3",
    "title": "Volvo Reports Record Q3 Results",
    "summary": "Volvo reported record third-quarter earnings, beating analyst expectations...",
    "article_count": 4,
    "published_at": "2026-03-15T09:30:00.000Z",
    "updated_at": "2026-03-15T14:00:00.000Z",
    "article_ids": [
      "art_abc123def",
      "art_def456ghi"
    ],
    "country": "SE",
    "company_ids": [
      "uejazctgchj4"
    ],
    "event_id": "8fzq2rmtnk5c",
    "content": "## Volvo Q3 Results\\n\\nVolvo reported record earnings...",
    "companies": [
      {
        "id": "uejazctgchj4",
        "name": "AB Volvo (Volvo Group)",
        "ticker": "VOLV-B"
      }
    ]
  }
}

Changes

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