Docs/Reference/Identifiers/Batch Resolve Identifiers
POST/v1/batch/identifiers

Batch Resolve Identifiers

Resolve up to 100 identifiers of any kind in one request.

Every input is accounted for: identifiers that match no entity are named in meta.unresolved rather than dropped, so a caller can always reconcile the response against what they sent.

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Request body · 1

JSON request body fields.

idsstring[]required

Identifiers to resolve (1-100). Any mix of EDINET codes, securities codes and investor identifiers.

Returns · 200

The standard { data, meta } envelope. data contains an array of IdentifiersOut.

Envelope

dataIdentifiersOut[]

Array of result objects.

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.