Skip to main content
GET
Entity Trademarks
Credits: 10 per page.

Overview

Returns a paginated, summary-tier list of every trademark whose owner is linked to the entity, the global-portfolio view. Where Owner Trademarks is one office’s record, this spans every owner record linked to the entity, in every office. It returns the marks of those linked records only: an owner record not yet linked to the entity is not included, and one company can be split across more than one entity. See the coverage caveats. The scope is exactly the entity_id filter on Search Trademarks: both read the same resolved entity ids on each mark, so both return the same set for the same entity and neither has a member-owner cap. The difference is resource semantics here: a missing entity is a 404, and a merged one a 410, where the filter answers an empty page. Without sort, a q search ranks by relevance, a request with a text filter such as mark_text_starts_with lists in text order, and anything else lists the newest filings first (-filing_date). Arrays are comma-separated, date ranges use flat _gte / _gt / _lte / _lt operators, and booleans follow the request conventions. The id must be a materialized entity: an owner id written in entity form (ent_<owner-uuid>) is a 404. For one owner’s marks, use Owner Trademarks.

Path Parameters

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

Query Parameters

The full Search Trademarks filter set applies (status, mark classification, identifiers, geography, Nice/Vienna codes, date ranges, public-company filters, and boolean flags), plus:
string
Ranked text search within the entity’s marks. One character is enough here; elsewhere q needs two. A trademark number in q is also looked up.
string
default:"identical,fuzzy,embedded,lookalike"
Channels for q. See Similarity.
string[]
Text filters: mark_text_is, mark_text_word, mark_text_starts_with, mark_text_ends_with, mark_text_contains and mark_text_pattern, each with a mark_text_not_* exclusion. Repeat the key for several values. See Text filters.
string[]
ID exclusions: owner_id_not, entity_id_not, entity_group_not and trademark_ids_not. See Exclusions.
boolean
default:"false"
Return 200 with search_meta.complete: false instead of 503 when the search times out. See Complete results.
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 entity 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 its GLEIF-reported subsidiaries in one call; subsidiaries that report no GLEIF parent are not reached.
string
Sort field(s), comma-separated, - prefix for descending. Default: relevance with q, text order with a text filter, otherwise -filing_date.
string
Comma-separated optional row projections. full_goods_services returns full classifications[].goods_services_text instead of the truncated summary text. This is the list-row vocabulary: Retrieve Trademark and Batch Trademarks take office_extensions instead, and their goods and services text is never truncated. List rows never carry attorneys[]; retrieve the record (or up to 100 at once with Batch Trademarks) to read them.
string
default:"grouped"
How Madrid international registrations are presented. grouped (default) returns one row per mark: an IR and the designations linked to it come back as a single row for the IR (office_code: "WO", no national application_number), with each designated territory under coverage.territories[] and its record at coverage.territories[].trademark.id. expanded returns one row per designation, so a US designation appears with its own US serial number. Some filters and sorts can only be served expanded; see international_registrations for the list.
string
Sparse top-level field projection, comma-separated. id and object are always retained. Unknown names return 400. Fields you don’t request are left out of each row, although the OpenAPI response schema still lists every field.
integer
default:"20"
Items per page (1-100).
string
Pagination cursor from a previous response.

Response

object[]
Trademark rows (the same row Search Trademarks returns). Each row’s owners[] carries entity_id (the linked entity, or null for an owner that is not linked) so you can confirm the grouping.
boolean
Whether more marks are available.
object
Cursor for the next page.

Code Examples