---
title: "List Companies"
method: GET
path: "/api/v1/companies"
tags: ["Companies"]
---

# List Companies

`GET /api/v1/companies`

## Request

- Base URL: `https://nordicfinancialnews.com`
- URL: `https://nordicfinancialnews.com/api/v1/companies`
- Auth: HTTP bearer

Returns a paginated list of companies covered in Nordic financial news, ordered alphabetically by name. Use `q` for full-text search across company names, ranked by relevance, or add `mode=semantic` to match `q` by meaning instead.

## Query parameters

- `limit` integer
- `cursor` string
- `fields` string
- `q` string
- `mode` 'semantic'
- `company` string
- `ticker` string
- `isin` string
- `country` string
- `market` string
- `domicile` string
- `exchange` string
- `sector` string
- `market_segment` string
- `listed` string
- `watchlist` string
- `is_active` string

## Headers

- `If-None-Match` string
- `If-Modified-Since` string

## Response `200`

Companies retrieved successfully

- object
  - `companies` CompanySummary[], required
    - `id` string, required: Unique company identifier
    - `name` string, required: Company name
    - `slug` string, required: URL-friendly company name
    - `ticker` string, nullable: Primary stock ticker (null if unlisted)
    - `isin` string, nullable: ISIN of the primary listing. Null if unlisted or unknown.
    - `former_tickers` string[], required: Tickers the company was formerly listed under, from delisted or renamed listings, excluding any that are still a current ticker. Always present; empty when none. The ticker filter resolves former tickers as well as the current one, so a match on an old ticker still returns the company; this field tells you the ticker you searched by is historical.
    - `is_active` boolean: Whether the company is currently active/operating
    - `exchange` object, nullable: Primary exchange where the company is listed
      - `id` string: Exchange identifier
      - `name` string: Exchange display name
      - `mic_code` string: ISO 10383 Market Identifier Code
    - `market_segment` 'large_cap' | 'mid_cap' | 'small_cap' | 'first_north_premier' | 'first_north_growth', nullable: Cap segment of the primary listing. Set only for Nasdaq Nordic markets (Stockholm, Helsinki, Copenhagen, Iceland and First North); null elsewhere, when unlisted, or when `exchange` is null. `first_north_premier` and `first_north_growth` are First North's Premier and Growth markets.
    - `also_listed_on` object[], required: The company's other active listings, excluding the primary listing above: cross-listings on other exchanges and additional share classes (which may be on the same exchange). Always present; empty when the company is single-listed or unlisted. The row's ticker, isin and exchange fields are the primary listing only. Company detail stock_listings is the authoritative full set.
      - `ticker` string, required: Ticker on this secondary exchange
      - `isin` string, nullable: ISIN of this listing. Null when unknown.
      - `mic_code` string, required: ISO 10383 Market Identifier Code of this exchange
  - `pagination` object
    - `count` integer
    - `next_cursor` string, nullable

## Other responses

- `304`: Not Modified
- `400`: Invalid parameter

---

[API](https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api.md) - [All operations](https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api/revisions/aa48db8c82fc?raw)