List Company Stories

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

import requests

url = "https://nordicfinancialnews.com/api/v1/companies/{identifier}/stories"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

require 'uri'
require 'net/http'

url = URI("https://nordicfinancialnews.com/api/v1/companies/{identifier}/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/companies/{identifier}/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>"
      },
      "event_id": "8fzq2rmtnk5c"
    }
  ],
  "pagination": {
    "count": 123,
    "next_cursor": "<string>"
  },
  "plan_limited": true
}

{
  "type": "https://docs.nordicfinancialnews.com/problems/invalid-parameter",
  "title": "Invalid parameter",
  "status": 400,
  "detail": "This endpoint is already scoped to a company by the path, so ticker cannot apply here. Use GET /api/v1/stories to filter the full collection by ticker.",
  "instance": "urn:request:a1b2c3",
  "parameter": "ticker"
}

Companies

List Company Stories

Returns stories that mention a specific company, ordered by publication date (newest first).

Parameters

Accepts the same q, sort, fields, updated_after, country, category, sources, published_after and published_before parameters as GET /api/v1/stories, with identical semantics, scoped to this company.

Rejected parameters

ticker, company, watchlist, listed, exchange, market, domicile, index and sector are rejected (400). The path already fixes the company; use GET /api/v1/stories to filter the full collection by them (watchlist=false and listed with any value other than true are ignored, as on the flat resource).

Caching

Requests with updated_after are not cached: they return Cache-Control: no-cache, no-store and no ETag. The ETag reflects the response as served, not only record timestamps: it changes when plan limits alter the visible set, and when a story’s visible article set changes, so a changed ETag does not necessarily mean a record was updated.

GET

api

companies

{identifier}

stories

List Company Stories

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

import requests

url = "https://nordicfinancialnews.com/api/v1/companies/{identifier}/stories"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

require 'uri'
require 'net/http'

url = URI("https://nordicfinancialnews.com/api/v1/companies/{identifier}/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/companies/{identifier}/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>"
      },
      "event_id": "8fzq2rmtnk5c"
    }
  ],
  "pagination": {
    "count": 123,
    "next_cursor": "<string>"
  },
  "plan_limited": true
}

{
  "type": "https://docs.nordicfinancialnews.com/problems/invalid-parameter",
  "title": "Invalid parameter",
  "status": 400,
  "detail": "This endpoint is already scoped to a company by the path, so ticker cannot apply here. Use GET /api/v1/stories to filter the full collection by ticker.",
  "instance": "urn:request:a1b2c3",
  "parameter": "ticker"
}

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.

If-Modified-Since

string

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

Path Parameters

identifier

string

required

Company ID or ticker symbol. Accepts the exchange-suffixed form (e.g. VOLV-B.ST); former tickers resolve too. When a ticker is shared by more than one company, the company with a listing on a Nordic exchange is returned, then the one with an active listing, then the most recently listed. Use the company ID for an unambiguous lookup.

Query Parameters

limit

integer

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

cursor

string

Opaque pagination cursor from a previous response. Mutually exclusive with q unless sort=latest is also given.

updated_after

string

ISO 8601 datetime. Returns only this company's 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. Mutually exclusive with sort=latest (with or without q). An updated_after walk is always ordered by updated_at.

fields

string

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

string

Full-text search query (2-200 characters). By default, results are ranked by relevance instead of publication date, as a single page with no cursor. Mutually exclusive with cursor unless sort=latest is also given. Disables caching.

sort

enum<string>

Result order for q. relevance (default) is a single relevance-ranked page with no cursor; it requires q, and returns 400 without one. latest turns q into a match filter under the endpoint's normal newest-first order (published_at descending) and the response is cursor-paginated like any other request; without q it is an accepted no-op (that's already the default order). Mutually exclusive with updated_after.

Available options:

relevance,

latest

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.

Response

Company stories retrieved successfully

stories

object[]

required

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 October 7, 2026

Overview

Events

Articles

Stories

Calendar Events

Search

Companies

Countries

Exchanges

Indices

Categories

Event Types

Sources

Watchlists

Utility

List Company Stories

Parameters

Rejected parameters

Caching

Authorizations

Headers

Path Parameters

Query Parameters

Response