List Entities
Entities
List Entities
List resolved entities, the cross-office identity over per-office owner records
GET
List Entities
Overview
Returns a paginated, summary-tier list of resolved entities. An entity is one real-world company linked across offices:Apple Inc (USPTO), Apple Inc (EUIPO), and Apple Inc (CIPO) are one entity, not three owners. Use this to find a company once instead of reconciling per-office owner fragments yourself.
The publicly_traded, ticker, and has_lei filters match on the entity’s aggregated public-company facts (the union of its members’ SEC/GLEIF links), so they catch a company even when only one of its office records carries the ticker.
Entities or owners, which one do I use? Entities are resolved real-world organizations (one company, linked across every office). Start here for company-level questions like “everything this company owns, everywhere.” Owners are the raw office-level record parties, where the same company appears once per office and per name variant. Reach for owners when you need provenance or want to display the exact record as an office filed it.
This list returns resolved (cross-office) entities only. An owner that isn’t linked to any others doesn’t appear here, but you can still look it up directly at Get Entity using its derived id, or find it via List Owners. If search is temporarily unavailable, the endpoint returns
503 with no fallback list.Query Parameters
string
Name typeahead / relevance search. When present, results default to relevance order.
string
Filter by ISO 3166-1 alpha-2 country code (e.g.
US, GB).string
Filter by entity type (e.g.
corporation, individual).boolean
true returns entities that are publicly listed: either a member owner is matched to an active SEC company with a ticker, or the entity is itself listed or a subsidiary of a listed company. false means no confirmed listing, not confirmed private. Strict true/false only.string
Exact stock ticker (uppercased server-side). Subsidiary-inclusive: matches the entity’s direct tickers (member SEC companies and its own listing) and inherited tickers, so
ticker=NKE returns Nike and its subsidiary entities.boolean
true returns entities with a GLEIF LEI. Strict true/false only.string
Exact GLEIF Legal Entity Identifier.
string
Sort field with optional
- prefix. One of -trademark_count, trademark_count, -name, name, -member_count, member_count. Default: -trademark_count (-relevance when q is set).boolean
default:"false"
When
true, includes a total count in pagination.total_count. The count is exact only up to 10,000; beyond that pagination.total_count_approximate is true.integer
default:"20"
Page size, between 1 and 100.
string
Opaque cursor returned in the previous response’s
pagination.cursor.Response
string
Always
list.object[]
boolean
Whether more entities are available.
object
Cursor for the next page (signed).
string
Unique request identifier for support and debugging.
Code Examples
Errors
Related Endpoints
- Get Entity: full entity detail with members
- Entity Trademarks: marks across all member owners
- Entity Family: GLEIF corporate parent and subsidiaries