---
title: "List ISINs"
method: GET
path: "/isins/"
tags: ["ISINs"]
---

# List ISINs

`GET /isins/`

## Request

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

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

---
Search and resolve ISINs (International Securities Identification Numbers) to companies.

## Query parameters

- `code` string
- `codes` string
- `company` integer
- `is_primary` boolean
- `page` integer
- `page_size` integer
- `search` string

## Response `200`

Success

- PaginatedISINList
  - `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` ISIN[], required
    - `code` string, required: The 12-character International Securities Identification Number.
    - `is_primary` boolean, required: Indicates if this is the primary ISIN for the company on this platform.
    - `company` 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.
    - `figi` string, required: The 12-character Financial Instrument Global Identifier (FIGI) for this specific listing.
    - `composite_figi` string, required: The composite FIGI representing the instrument across all exchanges in a given country.
    - `share_class_figi` string, required: The share class FIGI representing the instrument globally, regardless of exchange.
    - `security_type` string, required: Primary security type classification (e.g., Common Stock, ETP, REIT).
    - `security_type2` string, required: Secondary security type classification providing additional granularity.
    - `market_sector` string, required: Market sector classification from OpenFIGI (e.g., Equity, Govt, Corp).
    - `exch_code` string, required: Exchange code where this security is listed (e.g., GY, US, LN).
    - `figi_last_updated` string, date-time, nullable, required: Timestamp of the last successful FIGI data enrichment for this ISIN.

## Other responses

- `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)