List Stories
Returns a paginated list of published stories ordered by publication date (newest first). Each story synthesizes coverage of a single developing event from multiple source articles into one narrative. Supports filtering by country, category, source, and company ticker. Use GET /api/v1/sources to discover source IDs for the sources filter. Use updated_after for incremental syncing, or q for full-text search ranked by relevance.
Documentation Index
Fetch the complete documentation index at: https://docs.nordicfinancialnews.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
API Key authentication using Bearer token
Headers
ETag value from a previous response. Returns 304 Not Modified if data has not changed.
Query Parameters
Number of stories to return per page (default 25, max 100).
Opaque pagination cursor returned as pagination.next_cursor from a previous response. Mutually exclusive with q.
ISO 8601 datetime. Returns only stories updated after this timestamp. Use this for polling-based real-time updates: store the timestamp of your last sync, then request only newer results on each poll (see the Real-Time Updates guide at https://docs.nordicfinancialnews.com). Disables cursor pagination — all matching results are returned in a single response.
Full-text search query (2-200 characters). Results are ranked by relevance instead of publication date. Mutually exclusive with cursor. Disables caching.
Filter by country using ISO 3166-1 alpha-2 code (e.g. SE, NO, DK).
Filter by category ID.
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.
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.
ISO 8601 datetime. Returns stories published on or after this timestamp.
ISO 8601 datetime. Returns stories published before this timestamp.
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.