---
title: "Get Article Details"
method: GET
path: "/api/v1/articles/{id}"
tags: ["Articles"]
---

# Get Article Details

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

## Request

- Base URL: `https://nordicfinancialnews.com`
- URL: `https://nordicfinancialnews.com/api/v1/articles/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api/docs/api/v1/articles/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the details of a single article: an English headline, a short summary, key points, and associated companies, along with `article_url` pointing to the full original-language article at the source. Supports conditional requests via `If-None-Match` for efficient caching.

## Path parameters

- `id` string, required

## Query parameters

- `include_peripheral` boolean

## Headers

- `If-None-Match` string
- `If-Modified-Since` string

## Response `200`

Article found

- object
  - `article` ArticleDetail
    - `id` string, required: Unique article identifier
    - `title` string, required: Article title in English. Machine-translated when the source article is not in English.
    - `article_url` string, required: Link to the original article
    - `content_type` 'news' | 'analysis' | 'press_release' | 'market_commentary' | 'market_news' | 'trading_halt' | 'trading_event' | 'other', required: Type of article content
    - `published_at` string, date-time, required: When the article was published by its source (ISO 8601). This is editorial time, not the time the article reached this API. Use it to filter by when news happened, never to track what is new to you.
    - `updated_at` string, date-time, required: When the article was last updated (ISO 8601)
    - `category` object, required: Article category
      - `id` string
      - `name` string
    - `source` object, required: The news source that published this article
      - `id` string: Unique source identifier
      - `name` string
      - `domain` string
      - `source_type` 'news_publication' | 'wire_service' | 'press_release' | 'government' | 'trade_publication' | 'blog' | 'stock_exchange' | 'research'
    - `company_ids` string[], required: IDs of companies mentioned in the article
    - `country` string, nullable, required: Country code (ISO 3166-1 alpha-2)
    - `event_id` string, nullable: ID of the event this article belongs to. Null when the article has not been assigned to an event yet. An event that has since been merged or removed still answers `GET /events/{id}` with a tombstone rather than a 404.
    - `source_title` string: Original article title in source language
    - `summary` string: AI-generated English summary of the article: a machine translation and paraphrase of the source text, not verbatim.
    - `story_ids` string[]: IDs of published stories covering this article, if any
    - `companies` object[]: Companies mentioned in this article, primary company first
      - `id` string, required: Unique company identifier
      - `name` string, required: Company name
      - `ticker` string, nullable: Primary stock ticker
      - `is_primary` boolean, required: Whether this company is the primary subject of the article
      - `association_tier` 'principal' | 'peripheral', required: How the company relates to the article. `principal` (subject, partner, investor, competitor) is the default set; `peripheral` (source, advisor, passing mention) appears only when `include_peripheral=true`. Always present.
    - `key_points` string[]: Key points from the article. Machine-generated English paraphrases of statements in the source article, not verbatim quotations.

## Other responses

- `304`: Not Modified
- `401`: Unauthorized
- `404`: Article 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)