NOnordicfinancialnews
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, sector and market_segment 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/v1/companies/{identifier}/stories

Request

  • Base URL
    https://nordicfinancialnews.com
  • Auth
    HTTP bearer

Query parameters

limitinteger

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

cursorstring

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

updated_afterstring

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.

fieldsstring

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.

qstring

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'relevance' | 'latest'

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.

countrystring

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.

categorystring

Filter by category id (from GET /api/v1/categories). Comma-separated for multiple (e.g. cat_earnings1,cat_mna000001); unknown ids are ignored.

sourcesstring

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.

published_afterstring

ISO 8601 datetime, or YYYY-MM-DD for 00:00 UTC. Returns stories published on or after this timestamp.

published_beforestring

ISO 8601 datetime, or YYYY-MM-DD for 00:00 UTC. Returns stories published before this timestamp.

Headers

If-None-Matchstring

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

If-Modified-Sincestring

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

Response

Company stories retrieved successfully

plan_limitedboolean

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 response

{
  "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"
      ],
      "event_id": "8fzq2rmtnk5c"
    }
  ],
  "plan_limited": true
}

Changes

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