# ISIN and FIGI security master

> Maps every NGX ticker to its ISIN and FIGI. 152 securities, 147 with a verified ISIN. Resolve an ISIN or FIGI back to a ticker.

```http
GET https://koboterminal.com/api/ngxdata/identifiers
```

**Plan:** Starter and above (from ₦29,000 / $20 a month).

Identifiers are validated against the ISO 6166 check digit and cross-checked against a second independent source before publication. They are never computed or guessed: where a listing has no assigned ISIN the field is null. Useful for custody, settlement, portfolio imports and joining NGX data to global datasets.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `isin` | query | string | no | Resolve an ISIN to its security (e.g. `NGDANGCEM008`) |
| `figi` | query | string | no | Resolve a FIGI to its security |
| `identified_only` | query | boolean | no | Only securities with at least one identifier |
| `limit` | query | integer | no | Rows per page, default 200, max 500 |
| `offset` | query | integer | no | Pagination offset |

## Request

```bash
curl "https://koboterminal.com/api/ngxdata/identifiers?isin=NGDANGCEM008" \
  -H "X-API-Key: $KOBO_API_KEY"
```

```python
import os, requests

r = requests.get(
    "https://koboterminal.com/api/ngxdata/identifiers",
    params={"isin": "NGDANGCEM008"},
    headers={"X-API-Key": os.environ["KOBO_API_KEY"]},
    timeout=30,
)
r.raise_for_status()
data = r.json()
```

```javascript
const res = await fetch("https://koboterminal.com/api/ngxdata/identifiers?isin=NGDANGCEM008", {
  headers: { "X-API-Key": process.env.KOBO_API_KEY },
});
if (!res.ok) throw new Error(`Kobo API ${res.status}`);
const data = await res.json();
```

## Response

Real response from the live API on 18 November 2026, trimmed to the first item of each list:

```json
{
  "success": true,
  "count": 1,
  "total": 1,
  "limit": 200,
  "offset": 0,
  "has_more": false,
  "identifiers": [
    {
      "symbol": "DANGCEM",
      "legal_name": "Dangote Cement Plc",
      "isin": "NGDANGCEM008",
      "figi": "BBG0017Z8Z24",
      "isin_verified_at": "2026-09-12T03:21:20.248916+00:00"
    }
  ]
}
```

## Use it from an AI assistant

This endpoint is available as the `lookup_identifiers` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp).

## Errors

Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors).
