Skip to main content
GET
Firm Trademarks
Credits: 1 per page.

Overview

Returns a paginated list of trademarks whose filing names the specified firm for one of its attorneys. A filing that names no firm is not listed under any firm. Use this for firm-level competitive intelligence, client portfolio sweeps, or auditing prosecution patterns. 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, and _lt operators, and booleans follow the request conventions.

Path Parameters

string
required
Firm ID (firm_...).

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 this firm’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.
string
Sort field(s), comma-separated, - prefix for descending. Default: relevance with q, text order with a text filter, otherwise -filing_date.
string
Filter to marks owned by a specific owner (own_...).
string
Filter to marks prosecuted by a specific attorney at this firm (att_...).
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.
An attorney is usually recorded on one designation, not on the IR itself. On the grouped view that designation is listed under the IR’s row, so a US designation the attorney handled appears as the WO row. Pass international_registrations=expanded to list the designation itself, then retrieve it for its attorneys[].On the grouped view, status_primary and status_stage match an IR row when any of its territories has that status, not only the designation the firm is on. A filter for live marks can therefore return an IR whose designation for this firm is dead. Pass international_registrations=expanded to filter on the firm’s own designations.

Response

Returns a list envelope of trademark summary objects.

Code Examples