List Companies - Nordic Financial News

{ "companies": [ { "id": "comp_volvo123", "name": "Volvo AB", "slug": "volvo-ab", "ticker": "VOLV-B", "is_active": true, "exchange": { "id": "exch_xsto1234", "name": "Nasdaq Stockholm", "mic_code": "XSTO" } } ], "pagination": { "count": 1, "next_cursor": null } }

Authorizations

Authorization

string

header

required

API Key authentication using Bearer token

Query Parameters

limit

integer

Number of companies 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.

fields

string

Comma-separated list of fields to include in the response. Available fields: id, name, slug, ticker.

string

Full-text search query (2-200 characters). Searches company names and aliases. Results are ranked by relevance instead of alphabetical order. Mutually exclusive with cursor.

country

string

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

exchange

string

Filter by exchange MIC code (e.g. XSTO, XOSL, XCSE).

sector

string

Filter by industry sector (e.g. Financials, Industrials, Information Technology).

listed

string

When true, only return companies with at least one stock exchange listing.

watchlist

string

When true, only return companies in the authenticated user's watchlist. Requires read:watchlist scope.

is_active

string

Filter by active status. When true, only return active companies. When false, only return inactive companies.

Response

200 - application/json

Companies retrieved successfully

companies

object[]

required

Show child attributes

pagination

object

Show child attributes