Skip to main content
GET
Entity Trademarks

Overview

Returns a paginated, summary-tier list of trademarks held by all member owners of the entity, the global-portfolio view. Where Owner Trademarks is one office’s record, this fans out across every office the entity has been resolved into, so a single call returns the company’s worldwide portfolio. When neither sort nor q is supplied, results default to most-recent-first (-filing_date); a q text query instead ranks by relevance. Arrays are comma-separated, date ranges use flat _gte / _gt / _lte / _lt operators, and booleans must be the literal strings true or false. A derived ent_<owner-uuid> id is accepted and degrades to that one owner’s marks.

Path Parameters

string
required
Entity ID (e.g. ent_R3jK9mN2), including the derived ent_<owner-uuid> form.

Query Parameters

The full List Trademarks filter set applies (status, mark classification, identifiers, geography, Nice/Vienna codes, date ranges, public-company filters, and boolean flags), plus:
string
Relevance text search within the entity’s marks.
boolean
default:"false"
When true, expands the portfolio to this entity and all of its GLEIF family-tree descendants (a bounded, cycle-safe downward walk via parent_entity_id), then runs the same query over the combined member-owner set. Default false returns this entity only. A family graph larger than the walk bounds returns 422 with error.reason family_graph_too_large. Use this to pull a listed parent and every subsidiary in one call.
string
default:"-filing_date"
Sort field(s), comma-separated, - prefix for descending.
string
Comma-separated optional row projections. full_goods_services returns full classifications[].goods_services_text instead of the truncated summary text.
string
Sparse top-level field projection, comma-separated. id and object are always retained. Unknown names return 400.
integer
default:"20"
Items per page (1-100).
string
Pagination cursor from a previous response.

Response

object[]
Array of trademark summary objects across all member owners. Each row’s owners[] carries entity_id and entity_id_type so you can confirm the grouping.
boolean
Whether more marks are available.
object
Cursor for the next page.

Code Examples

Errors