Trademark Coverage
Details
Trademark Coverage
Madrid Protocol designation territories and their per-territory protection status
GET
Trademark Coverage
Documentation Index
Fetch the complete documentation index at: https://docs.signa.so/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Lists the territories designated under a Madrid Protocol International Registration and the per-territory protection status. This endpoint is meaningful only for marks withfiling_route = madrid_designation. For non-Madrid marks the response is an empty list.
Use this to see which jurisdictions an IR currently covers, what each one’s status is, and when each designation was made or refused.
Path Parameters
Trademark ID (
tm_...).Query Parameters
Filter by per-territory protection status. One of
designated, provisionally_refused, finally_refused, protected, withdrawn, renounced, ceased, invalidated, limited, expired.Page size (1-100).
Pagination cursor from a previous response.
Response
Array of coverage records.
Two-letter ISO territory code (e.g.
US, DE, JP).Human-readable territory name.
Current protection status in the territory.
ISO date the territory was first designated.
ISO date protection took effect, when granted.
ISO date of refusal, when applicable.
ISO date the current protection status became effective.
true when this territory was added after the original IR filing.Madrid Protocol article under which the designation was made.
Free-text limitation of the goods/services list for this territory, when applicable.
Additional status detail or office note.
Code Examples
Errors
| Status | Type | Description |
|---|---|---|
| 400 | validation_error | Invalid query parameter or trademark ID |
| 401 | unauthorized | Missing or invalid API key |
| 404 | not_found | Trademark not found |
| 429 | rate_limited | Too many requests |
Related Endpoints
- Get Trademark — parent IR detail
- Madrid Protocol guide — how Madrid filings, designations, and basic marks fit together
- Trademark Related — basic mark and other related records