---
title: "Get Story Details"
method: GET
path: "/api/v1/stories/{id}"
tags: ["Stories"]
---

# Get Story Details

`GET /api/v1/stories/{id}`

## Request

- Base URL: `https://nordicfinancialnews.com`
- URL: `https://nordicfinancialnews.com/api/v1/stories/{id}`
- Auth: HTTP bearer

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.

## Path parameters

- `id` string, required

## Headers

- `If-None-Match` string

## Response `200`

Story found

- object
  - `story` StoryDetail
    - `id` string, required: Unique story identifier
    - `title` string, required: Story title
    - `summary` string, required: Story summary
    - `article_count` integer, required: Number of articles in this story (matches the length of article_ids)
    - `published_at` string, date-time, required: When the story's newest source article was published (ISO 8601). This is editorial time, not the time the story reached this API: a story about older news carries an older date. Use it to filter by when news happened, never to track what is new to you.
    - `updated_at` string, date-time, required: When the story was last updated (ISO 8601)
    - `article_ids` string[]: IDs of articles in this story, most relevant first
    - `country` string, nullable: Country code (ISO 3166-1 alpha-2)
    - `company_ids` string[]: IDs of companies mentioned in this story
    - `category` object: Story category
      - `id` string
      - `name` string
    - `event_id` string, nullable: ID of the event this story was generated from. An event that has since been merged or removed still answers `GET /events/{id}` with a tombstone rather than a 404.
    - `content` string, markdown: Full story content in Markdown format
    - `companies` object[]: Companies mentioned in this story
      - `id` string: Unique company identifier
      - `name` string: Company name
      - `ticker` string, nullable: Primary stock ticker

## Other responses

- `304`: Not Modified
- `404`: Story not found

---

[API](https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api.md) - [All operations](https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api/revisions/aa48db8c82fc?raw)