List Company Articles
Returns articles where the company is a principal association (subject, partner, investor, or competitor), ordered by publication date (newest first). An article where this company is only the source, an advisor, or a passing mention is excluded.
Parameters
Accepts the same q, sort, fields, updated_after, country, category, sources, source_type, content_type, published_after and published_before parameters as GET /api/v1/articles, with identical semantics, scoped to this company. primary_only=true narrows further within that principal set, to only articles where this company is the primary subject.
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/articles 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, so a changed ETag does not necessarily mean a record was updated.
Authorizations
API Key authentication using Bearer token
Headers
ETag value from a previous response. Returns 304 Not Modified if data has not changed.
HTTP date from a previous Last-Modified header. Returns 304 Not Modified if nothing has changed since.
Path Parameters
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
Number of articles to return per page (default 25, max 100).
Opaque pagination cursor from a previous response. Mutually exclusive with q unless sort=latest is also given.
Comma-separated list of fields to include in the response. Reduces payload size. Available fields: id, title, article_url, published_at, updated_at, content_type, source, company_ids, country, category.
ISO 8601 datetime. Returns only this company's articles 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.
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.
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.
relevance, latest 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.
Filter by category id (from GET /api/v1/categories). Comma-separated for multiple (e.g. cat_earnings1,cat_mna000001); unknown ids are ignored.
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). Disabled sources resolve to empty results.
Filter by source type, comma-separated. Valid values: news_publication, wire_service, press_release, government, trade_publication, blog, stock_exchange, research. Articles from disabled sources are excluded. An unrecognized value returns 400 naming the bad value(s).
Filter by article content type, comma-separated. Valid values: news, analysis, press_release, market_commentary, market_news, trading_halt, trading_event, other. GET /api/v1/meta lists them as content_types. An unrecognized value returns 400 naming the bad value(s).
ISO 8601 datetime. Returns articles published on or after this timestamp.
ISO 8601 datetime. Returns articles published before this timestamp.
When true, narrows further within the already-principal match, to only articles where this company is the primary subject.
When true, widen this feed back to articles where the company is only a peripheral association (its source, an advisor, or a passing mention), which are otherwise excluded. Default false (principal-only). primary_only still keeps the primary-subject restriction even when peripheral is requested.