---
title: "Resolve entity identifier"
method: GET
path: "/v1/entities/resolve"
---

# Resolve entity identifier

`GET /v1/entities/resolve`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/entities/resolve`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Resolve one issuer, manager, insider, or fund from a market or SEC identifier, returning the canonical entity and match confidence.

## Query parameters

- `ticker` string
- `symbol` string
- `cik` string
- `figi` string
- `composite_figi` string
- `share_class_figi` string
- `isin` string
- `cusip` string
- `name` string
- `query` string
- `q` string
- `view` 'agent' | 'compact'

## Response `200`

Canonical entity record. matchConfidence and matchBasis explain how the supplied identifier resolved; requestId supports support and retry correlation.

- object

## Other responses

- `default`: Contract-aware error response. A missing or blank identifier returns 400 missing_identifier; an unresolved identifier returns 404 entity_not_found.

---

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