Docs/Reference/Identifiers/Resolve Identifier
GET/v1/identifiers

Resolve Identifier

Resolve an identifier of unknown kind to the entity it names.

Answers what the identifier IS (name, entity_id, cross-references) and where it WORKS (roles, and a links map from each role to the endpoint that serves it), so a caller holding an unfamiliar string reaches the data in one follow-up request instead of probing resources until one answers.

Query parameters · 1

Optional filters and modifiers. Pass as URL-encoded ?key=value.

idstringrequired

Any identifier form. Accepted forms: an EDINET code (E12345), a securities code (7203), or an investor identifier as returned by /v1/investors/search.

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains IdentifiersOut.

Envelope

dataIdentifiersOut

A single result object.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

IdentifiersOut

edinet_codestring | null

EDINET submitter code (e.g. 'E02144'). Null only when the identifier names an entity that has never filed under one of its own, which is possible for a group of co-filing investors.

securities_codestring | null

TSE securities code (e.g. '7203').

isinstring | null

ISIN (12-character international securities ID).

leistring | null

Legal Entity Identifier (20 characters). An entity-level identifier, so it is served from the resolved entity record and never from the listed-issuer cross-reference. Null when no entity record backs this identifier, or when that record carries no LEI; provenance.entity_registry says which.

jpx_codestring | null

JPX issuer code.

match_methodstring | null

How the market identifiers were matched (e.g. 'exact', 'fuzzy'). Null when this company is not in the listed-issuer cross-reference; provenance.market_identifiers says why.

confidencenumber | null

Match confidence (0.0 to 1.0). Null when there is no match to score.

matched_atstring · date-time | null

When the market identifiers were last matched. Null when never matched.

format date-time
entity_idstring | null

Stable key of the resolved entity behind this identifier. Null when no resolved entity record covers it.

namestring | null

The entity's name, as filed (Japanese).

name_enstring | null

English name, where we hold one.

rolesstring[]

Every role this entity holds: 'issuer' (company endpoints answer for it) and/or 'investor' (it files shareholding reports). An entity is legitimately both, so this is always a list.

linksobject

Role to the endpoint path that answers for this entity in that role.

provenanceIdentifierProvenance

What the null fields above mean. Always present.

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.