Skip to main content
GET
Get Trademark

Overview

Returns the full detail-tier representation of a single trademark: identification, status, filing and key dates, owners, attorneys, classifications, computed deadlines, media, and Madrid enrichment when applicable. All bounded children (owners, attorneys, classifications, media, etc.) are inlined. Unbounded children (events, proceedings, coverage, relationships) appear as counts only; fetch them from their own sub-resource endpoints.

Path Parameters

string
default:"tm_8kLm2nPq"
required
Trademark ID (e.g., tm_8kLm2nPq)

Query Parameters

string
Comma-separated optional detail projections. office_extensions includes the office_extensions object (raw office-specific data), which is otherwise omitted.
string
Sparse top-level field projection, comma-separated (e.g. ?fields=mark_text,status,owners). id and object are always retained. Unknown field names, or nested paths like status.primary, return 400.
string
Preferred goods/services language for classifications[] rows, applied only to records that carry per-language variants (direct and Madrid designation records; 2-3 letters with optional 2-letter region, e.g. en, eng, or en-US). When multiple language variants exist for the same Nice class, Signa returns the requested language if present; groups without the requested language — and IR-parent rollup classifications, which have no per-language variants — keep all rows in default classification order.
The ETag on this response varies with the requested projection and language: a request with ?include=, ?fields=, and/or ?language= gets a different validator than the plain request, so a cached full response never 304s a different representation.

Response

Returns the full detail-tier representation of a trademark, including all bounded children (owners, attorneys, classifications, etc.) inline. Unbounded children (events, proceedings) appear as counts only. Maintenance deadlines and opposition windows are computed at read time from the normalized record and rule registry.
string
Prefixed trademark ID (tm_*)
string
Always "trademark"
boolean
Whether the record has been retracted by the source office
string
Unique request identifier

Code Examples

Errors