search_trademarks
Search global trademark registrations by name, owner, Nice class, jurisdiction, or status. Supports exact, phonetic, fuzzy, and prefix matching across 21 international offices.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Trademark name or text to search for |
jurisdictions | string[] | No | Filter by jurisdiction codes (e.g., ["US", "EU", "WIPO"]) |
offices | string[] | No | Filter by office codes (e.g., ["USPTO", "EUIPO"]) |
nice_classes | number[] | No | Filter by Nice classification numbers (1-45) |
status | string | No | Filter by primary status: active or inactive |
status_stage | string[] | No | Filter by stage: filed, examining, published, registered, abandoned, cancelled, expired |
owner_country | string | No | Filter by owner country code (e.g., US, DE) |
limit | number | No | Results to return (default 20, max 50) |
cursor | string | No | Pagination cursor from previous result |
Example
“Search for trademarks similar to AURORA in Nice class 9 in the US and EU”The agent calls:
get_trademark
Get detailed information about a specific trademark, including owners, attorneys, classifications, events, and media.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Trademark ID (UUID or prefixed tm_* ID) |
list_trademarks
List trademark registrations with filtering and sorting. For text-based search, usesearch_trademarks instead.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
office | string | No | Filter by office code |
status | string | No | Filter by primary status |
status_stage | string[] | No | Filter by status stage |
nice_classes | number[] | No | Filter by Nice classes |
sort | string | No | Sort field (e.g., filing_date, -filing_date) |
limit | number | No | Results to return (default 20, max 100) |
cursor | string | No | Pagination cursor |
get_owner
Get detailed information about a trademark owner (applicant/registrant), including portfolio statistics.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Owner ID (UUID or prefixed ow_* ID) |
list_owners
Search and list trademark owners by name, country, or public company status.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | No | Search by owner name |
country_code | string | No | Filter by country code |
has_public_company | boolean | No | Filter to owners linked to public companies |
limit | number | No | Results to return (default 20, max 100) |
cursor | string | No | Pagination cursor |
get_attorney
Get detailed information about a trademark attorney or representative of record.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Attorney ID (UUID or prefixed att_* ID) |
list_attorneys
Search and list trademark attorneys/representatives.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | No | Search by attorney name |
firm_id | string | No | Filter by firm ID |
country_code | string | No | Filter by country code |
limit | number | No | Results to return (default 20, max 100) |
cursor | string | No | Pagination cursor |
get_firm
Get detailed information about a law firm, including their trademark portfolio and attorneys.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Firm ID (UUID or prefixed fm_* ID) |
get_proceeding
Get detailed information about a trademark proceeding (opposition, cancellation, etc.).Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Proceeding ID (UUID or prefixed prc_* ID) |
list_proceedings
List trademark proceedings with filtering.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
trademark_id | string | No | Filter by trademark ID |
proceeding_type | string | No | Type: opposition, cancellation, concurrent_use, interference |
status | string | No | Filter by proceeding status |
limit | number | No | Results to return (default 20, max 100) |
cursor | string | No | Pagination cursor |
suggest
Quick typeahead search across trademarks, owners, attorneys, and firms. Returns compact results useful for disambiguation when you need to identify the right entity before fetching details.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search text |
entity_type | string | No | Filter to: trademark, owner, attorney, or firm |
limit | number | No | Suggestions to return (default 10, max 20) |