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

# List Companies

`GET /companies/`

## Request

- Base URL: `https://api.financialreports.eu`
- URL: `https://api.financialreports.eu/companies/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

**Access Level Required:** Requires **Standard Access (Level 1)**.

---
Retrieve a paginated list of companies.

## Query parameters

- `cik` string
- `countries` string
- `date_public_after` string, date
- `date_public_before` string, date
- `date_public_cursor` string
- `industry` string
- `industry_group` string
- `isin` string
- `lei` string
- `listing_status` 'DELISTED' | 'LISTED' | 'SUSPENDED' | 'UNKNOWN'
- `oics_class` string
- `oics_entity_type` string
- `oics_group` string
- `oics_industry` string
- `oics_sector` string
- `on_watchlist` boolean
- `ordering` string
- `page` integer
- `page_size` integer
- `search` string
- `sector` string
- `sub_industry` string
- `ticker` string
- `view` 'full' | 'summary'

## Response `200`

Success. The response structure will be the full Company object if `view=full` is used.

- PaginatedCompanyMinimalList
  - `count` integer, required: Total matching results. Exact for cheap queries, an estimate on broad or expensive ones. Do not use it to decide when to stop: follow `next` until it is null.
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` CompanyMinimal[], required
    - `id` integer, required: Unique identifier for the company.
    - `name` string, required: Company name.
    - `tagline` string, required: A short, one-liner describing the company's value proposition.
    - `isins` string[], required: Primary ISIN(s) for the company. Use the company detail endpoint for the full list.
    - `lei` string, required: Legal Entity Identifier (ISO 17442).
    - `sub_industry_code` string, nullable, required: ISIC classification code classifying the company.
    - `oics_code` string, nullable, required: The company's primary OICS class code (public preview, OICS v0.3), e.g. `TC.SC.SEM.CHP`. Null when the company has no class under the current OICS version, including entity types that carry none (funds, shells, financing vehicles). The full label is the `oics` object on the full company representation.
    - `country_code` string, required: ISO 3166-1 alpha-2 country code of the company's primary registration or headquarters.
    - `date_public` string, date, nullable, required: Date this company record was last updated on the FinancialFilings platform. With `id`, it is the `date_public_cursor` of an incremental company sync.

## Other responses

- `401`: Unauthorized
- `403`: Missing or invalid API key, or the plan does not include this endpoint.
- `429`: Rate limit, plan quota or spend cap reached.

---

[API](https://skmtc.dev/financialreports/apis/financialfilings-api.md) · [All operations](https://skmtc.dev/financialreports/apis/financialfilings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/financialreports/apis/financialfilings-api/revisions/a780251d6b05?raw)