Articles

Get Article Details

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.

get/api/v1/articles/{id}

Request

Path parameters

idstring required

Article ID (e.g. art_abc123def).

Query parameters

include_peripheralboolean

When true, widen companies and company_ids back to peripheral associations (a company named only as the article's source, an advisor, or a passing mention), which are otherwise excluded. Default false (principal-only). Each companies[] entry always carries association_tier regardless of this parameter.

Headers

If-None-Matchstring

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

If-Modified-Sincestring

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

Response

Article found

Example response

{
  "article": {
    "id": "art_abc123def",
    "title": "Volvo Reports Record Q3 Earnings",
    "article_url": "https://di.se/articles/volvo-q3-2026",
    "content_type": "news",
    "published_at": "2026-03-15T09:30:00.000Z",
    "updated_at": "2026-03-15T10:00:00.000Z",
    "category": {
      "id": "cat_earnings1",
      "name": "Earnings & Financial Results"
    },
    "source": {
      "id": "abc123def456",
      "name": "Dagens Industri",
      "domain": "di.se",
      "source_type": "news_publication"
    },
    "company_ids": [
      "uejazctgchj4"
    ],
    "country": "SE",
    "event_id": "8fzq2rmtnk5c",
    "source_title": "Volvo rapporterar rekordresultat för Q3",
    "summary": "Volvo reported record Q3 earnings driven by strong truck demand...",
    "story_ids": [
      "story_volvo_q3"
    ],
    "companies": [
      {
        "id": "uejazctgchj4",
        "name": "AB Volvo (Volvo Group)",
        "ticker": "VOLV-B",
        "is_primary": true,
        "association_tier": "principal"
      }
    ],
    "key_points": [
      "Revenue up 15% year-over-year",
      "Strong truck demand in Europe"
    ]
  }
}

Changes

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