Trademark Coverage

curl --request GET \
  --url https://api.signa.so/v1/trademarks/{id}/coverage \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.signa.so/v1/trademarks/{id}/coverage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.signa.so/v1/trademarks/{id}/coverage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.signa.so/v1/trademarks/{id}/coverage"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.signa.so/v1/trademarks/{id}/coverage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "territory_code": "US",
      "territory_name": "United States",
      "protection_status": "protected",
      "designation_date": "2024-03-15",
      "protection_date": "2025-01-21",
      "refusal_date": null,
      "status_effective_date": "2025-01-21",
      "is_subsequent_designation": false,
      "designation_protocol": "p",
      "goods_limitations": null,
      "status_detail": null
    },
    {
      "territory_code": "DE",
      "territory_name": "Germany",
      "protection_status": "provisionally_refused",
      "designation_date": "2024-03-15",
      "protection_date": null,
      "refusal_date": "2024-09-02",
      "status_effective_date": "2024-09-02",
      "is_subsequent_designation": false,
      "designation_protocol": "p",
      "goods_limitations": null,
      "status_detail": "Likelihood of confusion with prior right"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_xyz"
}

GET

trademarks

{id}

coverage

Trademark Coverage

curl --request GET \
  --url https://api.signa.so/v1/trademarks/{id}/coverage \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.signa.so/v1/trademarks/{id}/coverage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.signa.so/v1/trademarks/{id}/coverage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.signa.so/v1/trademarks/{id}/coverage"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.signa.so/v1/trademarks/{id}/coverage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "territory_code": "US",
      "territory_name": "United States",
      "protection_status": "protected",
      "designation_date": "2024-03-15",
      "protection_date": "2025-01-21",
      "refusal_date": null,
      "status_effective_date": "2025-01-21",
      "is_subsequent_designation": false,
      "designation_protocol": "p",
      "goods_limitations": null,
      "status_detail": null
    },
    {
      "territory_code": "DE",
      "territory_name": "Germany",
      "protection_status": "provisionally_refused",
      "designation_date": "2024-03-15",
      "protection_date": null,
      "refusal_date": "2024-09-02",
      "status_effective_date": "2024-09-02",
      "is_subsequent_designation": false,
      "designation_protocol": "p",
      "goods_limitations": null,
      "status_detail": "Likelihood of confusion with prior right"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_xyz"
}

Overview

Lists the territories designated under a Madrid Protocol International Registration and the per-territory protection status. This endpoint is meaningful only for marks with filing_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

string

required

Trademark ID (tm_...).

Query Parameters

string

Filter by per-territory protection status. One of designated, provisionally_refused, finally_refused, protected, withdrawn, renounced, ceased, invalidated, limited, expired.

integer

default:"20"

Page size (1-100).

string

Pagination cursor from a previous response.

Response

object[]

Array of coverage records.

string

Two-letter ISO territory code (e.g. US, DE, JP).

string

Human-readable territory name.

string

Current protection status in the territory.

string

ISO date the territory was first designated.

string

ISO date protection took effect, when granted.

string

ISO date of refusal, when applicable.

string

ISO date the current protection status became effective.

boolean

true when this territory was added after the original IR filing.

string

Madrid Protocol article under which the designation was made.

string

Free-text limitation of the goods/services list for this territory, when applicable.

string

Additional status detail or office note.

{
  "object": "list",
  "data": [
    {
      "territory_code": "US",
      "territory_name": "United States",
      "protection_status": "protected",
      "designation_date": "2024-03-15",
      "protection_date": "2025-01-21",
      "refusal_date": null,
      "status_effective_date": "2025-01-21",
      "is_subsequent_designation": false,
      "designation_protocol": "p",
      "goods_limitations": null,
      "status_detail": null
    },
    {
      "territory_code": "DE",
      "territory_name": "Germany",
      "protection_status": "provisionally_refused",
      "designation_date": "2024-03-15",
      "protection_date": null,
      "refusal_date": "2024-09-02",
      "status_effective_date": "2024-09-02",
      "is_subsequent_designation": false,
      "designation_protocol": "p",
      "goods_limitations": null,
      "status_detail": "Likelihood of confusion with prior right"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_xyz"
}

Code Examples

curl "https://api.signa.so/v1/trademarks/tm_abc123/coverage?protection_status=protected" \
  -H "Authorization: Bearer sig_YOUR_KEY"

import { Signa } from "@signa-so/sdk";

const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

const coverage = await signa.trademarks.coverage("tm_abc123", {
  protection_status: "protected",
});

for (const c of coverage.data) {
  console.log(c.territory_code, c.protection_status);
}

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

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

Overview

Trademarks

Parties

Records

Monitoring

Reference

Analytics

Bulk & Sync

Administration

SDK

Trademark Coverage

Overview

Path Parameters

Query Parameters

Response

Code Examples

Errors

​Overview

​Path Parameters

​Query Parameters

​Response

​Code Examples

​Errors

​Related Endpoints

Overview

Path Parameters

Query Parameters

Response

Code Examples

Errors

Related Endpoints