---
title: "Find the Certvas ID for an outside identifier."
method: GET
path: "/v1/crosswalk"
---

# Find the Certvas ID for an outside identifier.

`GET /v1/crosswalk`

## Request

- Base URL: `https://api.certvas.com`
- URL: `https://api.certvas.com/v1/crosswalk`
- Auth: API key in header `X-API-Key`

Look up by `lei` or `ticker` (EXCHANGE:TICKER) on any tier; by `registry`, `opencorporates`, `isin` or `figi` on the starter tier and above. A registry number is unique only within its registry, so a lookup can match more than one organisation; the response then carries `ambiguous: true`. At most 20 matches.

## Query parameters

- `id_type` 'lei' | 'ticker' | 'registry' | 'opencorporates' | 'isin' | 'figi', required
- `id_value` string, required

## Response `200`

Matching Certvas IDs.

- object

## Other responses

- `400`: A parameter is malformed or missing; the body names it.
- `401`: Missing or invalid API key.
- `402`: A sample-tier key asked for more than the sample tier serves: more rows than its cap, or a lookup in the paid crosswalk. The body and the X-Upgrade-URL header carry the upgrade link. Omit `limit` for the free preview.
- `429`: Rate limited: the per-minute burst limit or the monthly cap was reached.
- `503`: The key store is temporarily unavailable; retry.

---

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