List Stories - Nordic Financial News

List Stories

curl --request GET \
  --url https://nordicfinancialnews.com/api/v1/stories \
  --header 'Authorization: Bearer <token>'

require 'uri'
require 'net/http'

url = URI("https://nordicfinancialnews.com/api/v1/stories")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://nordicfinancialnews.com/api/v1/stories', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "stories": [
    {
      "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-15T09:35:00.000Z",
      "article_ids": [
        "art_abc123def",
        "art_def456ghi"
      ],
      "country": "SE",
      "company_ids": [
        "uejazctgchj4"
      ],
      "category": {
        "id": "<string>",
        "name": "<string>"
      }
    }
  ],
  "pagination": {
    "count": 25,
    "next_cursor": "<string>"
  },
  "plan_limited": true
}

{
  "type": "https://docs.nordicfinancialnews.com/problems/auth-invalid",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Missing or invalid API key",
  "instance": "urn:request:abc123"
}

GET

/

api

/

v1

/

stories

List Stories

curl --request GET \
  --url https://nordicfinancialnews.com/api/v1/stories \
  --header 'Authorization: Bearer <token>'

require 'uri'
require 'net/http'

url = URI("https://nordicfinancialnews.com/api/v1/stories")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://nordicfinancialnews.com/api/v1/stories', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "stories": [
    {
      "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-15T09:35:00.000Z",
      "article_ids": [
        "art_abc123def",
        "art_def456ghi"
      ],
      "country": "SE",
      "company_ids": [
        "uejazctgchj4"
      ],
      "category": {
        "id": "<string>",
        "name": "<string>"
      }
    }
  ],
  "pagination": {
    "count": 25,
    "next_cursor": "<string>"
  },
  "plan_limited": true
}

{
  "type": "https://docs.nordicfinancialnews.com/problems/auth-invalid",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Missing or invalid API key",
  "instance": "urn:request:abc123"
}

Authorizations

Authorization

string

header

required

API Key authentication using Bearer token

Headers

If-None-Match

string

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

Query Parameters

limit

integer

Number of stories to return per page (default 25, max 100).

cursor

string

Opaque pagination cursor returned as pagination.next_cursor from a previous response. Mutually exclusive with q.

updated_after

string

ISO 8601 datetime. Returns only stories updated after this timestamp. Use this for incremental sync: store the timestamp of your last completed sync, then request only newer results on each poll. Results are ordered by updated_at ascending and are cursor-paginated — follow pagination.next_cursor, resending the same updated_after value, until it is null. Only advance your stored timestamp once you have drained every page (see the Real-Time Updates guide at https://docs.nordicfinancialnews.com).

q

string

Full-text search query (2-200 characters). Results are ranked by relevance instead of publication date. Mutually exclusive with cursor. Disables caching.

country

string

Filter by country using ISO 3166-1 alpha-2 code (e.g. SE, NO, DK). Comma-separated for multiple (e.g. SE,NO). Case-insensitive.

category

string

Filter by category ID.

sources

string

Comma-separated list of source IDs (max 25). Use GET /api/v1/sources to discover source IDs. Also accepts array form (sources[]=id1&sources[]=id2). Returns stories with at least one article from a listed source.

ticker

string

Filter by company stock ticker symbol (e.g. VOLV-B). Accepts full tickers with exchange suffix (e.g. VOLV-B.ST). Returns stories mentioning the company. Former tickers resolve too — a company that renamed or moved venues is still reachable by an old ticker; the returned company former_tickers lists any such historical tickers.

company

string

Filter to a single company by its id (as returned by the companies endpoints). Complements ticker; use this to reach companies without a stock listing.

exchange

string

Filter by exchange using ISO 10383 Market Identifier Code (e.g. XSTO for Nasdaq Stockholm, XCSE for Nasdaq Copenhagen, XHEL for Nasdaq Helsinki, XOSL for Oslo Børs). Returns stories about companies actively listed there. Case-insensitive.

index

string

Filter by stock index id or symbol (e.g. OMXS30, OMXC25, OMXH25, OBX). Returns stories about companies in that index. Case-insensitive for symbols.

sector

string

Filter by company sector. Case-sensitive; must exactly match one of: Communication Services, Consumer Discretionary, Consumer Staples, Energy, Financials, Health Care, Industrials, Information Technology, Materials, Real Estate, Utilities.

watchlist

string

Restricts to stories mentioning companies in a single watchlist, identified by its id (from the List Watchlists endpoint). An unknown id returns no stories. Requires read:watchlist scope.

published_after

string

ISO 8601 datetime. Returns stories published on or after this timestamp.

published_before

string

ISO 8601 datetime. Returns stories published before this timestamp.

fields

string

Comma-separated list of fields to include in the response. Available fields: id, title, summary, published_at, article_count, article_ids, country, category, topics, companies.

Response

Stories retrieved

stories

object[]

Show child attributes

pagination

object

Show child attributes

plan_limited

boolean

Present and true when your plan restricted what this endpoint can return, so the result may be incomplete. Absent when your plan applies no restriction.

Example:

true

Last modified on August 21, 2026