Response Tiers
To optimize payload size, Signa returns trademark data at three detail levels:| Tier | Use Case | Fields |
|---|---|---|
| Compact | List views, autocomplete | ID, mark text, status stage, filing date |
| Summary | Search results, portfolio views | Compact + owner, Nice classes, jurisdiction |
| Detail | Full record view | Everything: events, media, attorneys, deadlines |
GET /v1/trademarks/{id} always returns detail, while list and search endpoints return summary:
Trademark Lifecycle
A trademark moves through these status stages:status.primary field indicates the high-level state (active, pending, or inactive), while status.stage reflects the current canonical lifecycle stage.
Key Fields
mark_text— The word mark as filed (may be null for design marks)nice_classes— International classification of goods and services (1-45)office_code— Office where the mark is registered (e.g.,uspto,euipo,wipo)filing_route— How the mark was filed:direct_national,madrid_ir,madrid_designation,direct_regional, etc.renewal_due_date— Next renewal deadline (computed from jurisdiction rules)