---
title: "Get by ISIN"
method: POST
path: "/v1/knowledge-graph/companies/isin"
tags: ["Companies"]
---

# Get by ISIN

`POST /v1/knowledge-graph/companies/isin`

Locate companies using International Securities Identification Numbers (ISIN), enabling coverage of both equities and fixed income instruments.

## Request body

- ISINRequest — Request body for ISIN lookups
  - `values` string[], required — Array of ISIN codes

## Response `200`

Successful response with company data mapped by ISIN

- MarketIdResponse — Response containing company data mapped by market identifiers
  - `results` object, required — Object containing market identifiers as keys and company data as values
  - `metadata` object, required
    - `request_id` string, required — Unique request identifier
    - `timestamp` string, date-time, required — Response timestamp
  - `usage` Usage
    - `knowledge_graph_tokens` integer, required — Number of tokens consumed by this request.

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)