Skip to main content
GET
List Owners

Overview

Returns a paginated, summary-tier list of trademark owners. Supports fuzzy name search, country and entity-type filters, plus virtual filters that join public-company enrichment to find owners with SEC ticker or GLEIF LEI matches. Suppressed owners (placeholder records, frozen entities) are always excluded.
Owners or entities, which one do I use? Owners are the raw office-level record parties: the same company appears once per office and per name variant, exactly as each office filed it. Use owners for provenance or exact-record display. For company-level questions (“everything this company owns, everywhere”), start with Entities, the resolved real-world organizations that link these owner records together.

Query Parameters

q
string
Fuzzy name search via trigram similarity. Tolerant of typos and word reordering.
country_code
string
Filter by ISO 3166-1 alpha-2 country code (e.g. US, GB).
entity_type
string
Filter by entity type (e.g. corporation, individual, partnership).
ticker
string
Virtual filter: matches owners linked to a public company with the given stock ticker (e.g. AAPL).
lei
string
Virtual filter: matches owners linked to a GLEIF Legal Entity Identifier.
publicly_traded
boolean
Virtual filter: true returns owners matched to an active SEC company with a ticker. false means no confirmed active ticker match, not confirmed private. Strict true/false only.
has_lei
boolean
Virtual filter: true returns owners matched to a GLEIF legal entity. false means no confirmed LEI match. Strict true/false only.
sort
string
Sort field with optional - prefix for descending. One of -trademark_count, trademark_count, -grant_rate, grant_rate, -latest_filing, latest_filing, -name, name. Default: -trademark_count.
include_total
boolean
default:"false"
When true, includes an accurate total count in pagination.total_count.
limit
integer
default:"20"
Page size, between 1 and 100.
cursor
string
Opaque cursor returned in the previous response’s pagination.cursor.

Response

object
string
Always list.
data
object[]
has_more
boolean
Whether more owners are available.
pagination
object
Cursor for the next page.
request_id
string
Unique request identifier for support and debugging.

Code Examples

Errors