---
title: "Retrieve ISIN"
method: GET
path: "/isins/{code}/"
tags: ["ISINs"]
---

# Retrieve ISIN

`GET /isins/{code}/`

## Request

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

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

---
Retrieve details for a specific ISIN.

## Path parameters

- `code` string, required

## Response `200`

Success

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