Skip to main content
GET
Retrieve Entity
Credits: 1 per record.

Overview

Retrieve a single company profile by ID. A resolved entity embeds its member owners (one per office) with the per-link evidence that justified each link. Public-company facts (publicly_traded, ticker, tickers, lei, has_lei) are aggregated over the member companies and returned on the entity: the union of every member’s SEC/GLEIF matches, so the profile carries a company’s ticker even when only one office record does. An ent_* id is a materialized entity: a company profile that links owner records across offices. An owner that is not linked to any entity has entity_id: null and is read with Retrieve Owner; an owner id written in entity form (ent_<owner-uuid>, which older API versions returned for such owners) is a 404 here, linked owner or not. A merged entity returns 410 with its successor.

Path Parameters

string
required
Entity ID (e.g. ent_R3jK9mN2).

Response

string
Entity ID (ent_*).
string
Always entity.
string
The entity’s display name, chosen from its member records.
string | null
ISO 3166-1 alpha-2 country code.
The kind of legal person (e.g. corporation), normalised from the member owners’ office entity-type codes.
boolean
Whether the entity is publicly listed: any active SEC company with a ticker across members, or the entity is itself listed or a subsidiary of a listed company. false means no confirmed listing, not confirmed-private.
string | null
The entity’s ticker, the first of tickers; null when none.
string[]
Deduped, uppercased tickers: member-company SEC tickers unioned with the entity’s own listing ticker, whether direct or inherited from a listed ancestor (so this includes an inherited subsidiary ticker). Direct-vs-inherited provenance lives in the listing block below.
string | null
The entity’s LEI, uppercased: its own LEI when set, else the first GLEIF LEI across member companies. null when none.
boolean
Whether the entity has an LEI: its own, or any GLEIF LEI across member companies.
integer | null
Distinct trademarks across all members (co-owned marks counted once). null when the count could not be computed in time for a very large entity; the rest of the entity is still returned.
integer | null
Count of active trademarks (registered + pending), computed live across all member owners; always <= trademark_count. null whenever trademark_count is null.
integer
Number of member owners.
string | null
GLEIF parent entity id, when present.
object | null
Public-listing decoration. Present only when the entity is listed or a subsidiary of a listed company; the whole block is omitted otherwise (an absent block means “no listing / unknown”, never confirmed-private).
object[]
string
Last change to the entity or its membership (drives the ETag).
string
Unique request identifier for support.
The link field is a small, stable projection: a link method, a confidence band, and matched identifiers, when applicable. The details of how the match was made aren’t returned through the API.

Code Examples