Retrieve a trademark

curl "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba" \
  -H "Authorization: Bearer $PINAKEL_API_KEY"

import os

import requests

tm_id = "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
resp = requests.get(
    f"https://api.pinakelai.com/v1/trademarks/{tm_id}",
    headers={"Authorization": f"Bearer {os.environ['PINAKEL_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
record, etag = resp.json(), resp.headers["ETag"]

const id = "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba";
const res = await fetch(`https://api.pinakelai.com/v1/trademarks/${id}`, {
  headers: { Authorization: `Bearer ${process.env.PINAKEL_API_KEY}` },
});
const record = await res.json();
const etag = res.headers.get("ETag");

{
  "object": "trademark",
  "id": "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba",
  "jurisdiction": "AD",
  "office": "AD",
  "origin_office": null,
  "identifiers": {
    "application_number": "48000",
    "registration_number": "48000",
    "international_registration_numbers": [],
    "priority_claims": []
  },
  "mark": {
    "text": "NOKY",
    "translation": null,
    "transliteration": null,
    "feature": "word",
    "kind": "individual"
  },
  "status": {
    "value": "registered",
    "category": "live",
    "date": "2009-06-05",
    "office_status": null,
    "office_status_code": null
  },
  "dates": {
    "application": "2009-06-05",
    "registration": "2009-06-05",
    "publication": "2025-07-28",
    "expiry": "2029-06-05",
    "renewal": null,
    "termination": null,
    "opposition_period_end": null
  },
  "classification": {
    "nice_classes": [8, 16, 21],
    "national_classes": [],
    "similar_group_codes": [],
    "vienna_codes": []
  },
  "parties": {
    "owners": [
      {
        "name": "ESSITY PLD FRANCE SAS",
        "name_translated": null,
        "name_key": "ESSITY PLD FRANCE",
        "country": null,
        "address": "BOULEVARD VICTOR-HUGO, CS 80047, 151, POSTAL CODE: 93400, CITY: SAINT-OUEN, FRANCE",
        "entity": "SAS",
        "roles": ["owner", "applicant"]
      }
    ],
    "representatives": [
      {
        "name": "JOSEP CARBONELL GIMENO",
        "name_translated": null,
        "name_key": "JOSEP CARBONELL GIMENO",
        "country": "AD",
        "address": "C. Bonaventura Riberaygua, 39, 4t - 3a Andorra la Vella",
        "entity": null,
        "roles": ["representative"]
      }
    ]
  },
  "designated_countries": [],
  "media": {
    "has_image": false
  },
  "updated_at": "2026-11-10T09:02:13.512000Z",
  "source": {
    "processed_on": "2026-11-10"
  },
  "links": {
    "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
  }
}

{
  "type": "https://docs.pinakelai.com/errors/not-found",
  "title": "Not found",
  "status": 404,
  "detail": "No trademark with id tm_AD_no-such-record.",
  "request_id": "req_01M7Q41C4D5E6F7G8H9J0K1M2N"
}

{
  "type": "https://docs.pinakelai.com/errors/jurisdiction-unavailable",
  "title": "Jurisdiction unavailable",
  "status": 503,
  "detail": "Register AD is being reloaded.",
  "request_id": "req_01M7Q41D5E6F7G8H9J0K1M2N3P"
}

GET

trademarks

{id}

curl "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba" \
  -H "Authorization: Bearer $PINAKEL_API_KEY"

import os

import requests

tm_id = "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
resp = requests.get(
    f"https://api.pinakelai.com/v1/trademarks/{tm_id}",
    headers={"Authorization": f"Bearer {os.environ['PINAKEL_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
record, etag = resp.json(), resp.headers["ETag"]

const id = "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba";
const res = await fetch(`https://api.pinakelai.com/v1/trademarks/${id}`, {
  headers: { Authorization: `Bearer ${process.env.PINAKEL_API_KEY}` },
});
const record = await res.json();
const etag = res.headers.get("ETag");

{
  "object": "trademark",
  "id": "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba",
  "jurisdiction": "AD",
  "office": "AD",
  "origin_office": null,
  "identifiers": {
    "application_number": "48000",
    "registration_number": "48000",
    "international_registration_numbers": [],
    "priority_claims": []
  },
  "mark": {
    "text": "NOKY",
    "translation": null,
    "transliteration": null,
    "feature": "word",
    "kind": "individual"
  },
  "status": {
    "value": "registered",
    "category": "live",
    "date": "2009-06-05",
    "office_status": null,
    "office_status_code": null
  },
  "dates": {
    "application": "2009-06-05",
    "registration": "2009-06-05",
    "publication": "2025-07-28",
    "expiry": "2029-06-05",
    "renewal": null,
    "termination": null,
    "opposition_period_end": null
  },
  "classification": {
    "nice_classes": [8, 16, 21],
    "national_classes": [],
    "similar_group_codes": [],
    "vienna_codes": []
  },
  "parties": {
    "owners": [
      {
        "name": "ESSITY PLD FRANCE SAS",
        "name_translated": null,
        "name_key": "ESSITY PLD FRANCE",
        "country": null,
        "address": "BOULEVARD VICTOR-HUGO, CS 80047, 151, POSTAL CODE: 93400, CITY: SAINT-OUEN, FRANCE",
        "entity": "SAS",
        "roles": ["owner", "applicant"]
      }
    ],
    "representatives": [
      {
        "name": "JOSEP CARBONELL GIMENO",
        "name_translated": null,
        "name_key": "JOSEP CARBONELL GIMENO",
        "country": "AD",
        "address": "C. Bonaventura Riberaygua, 39, 4t - 3a Andorra la Vella",
        "entity": null,
        "roles": ["representative"]
      }
    ]
  },
  "designated_countries": [],
  "media": {
    "has_image": false
  },
  "updated_at": "2026-11-10T09:02:13.512000Z",
  "source": {
    "processed_on": "2026-11-10"
  },
  "links": {
    "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
  }
}

{
  "type": "https://docs.pinakelai.com/errors/not-found",
  "title": "Not found",
  "status": 404,
  "detail": "No trademark with id tm_AD_no-such-record.",
  "request_id": "req_01M7Q41C4D5E6F7G8H9J0K1M2N"
}

{
  "type": "https://docs.pinakelai.com/errors/jurisdiction-unavailable",
  "title": "Jurisdiction unavailable",
  "status": 503,
  "detail": "Register AD is being reloaded.",
  "request_id": "req_01M7Q41D5E6F7G8H9J0K1M2N3P"
}

Returns the full trademark record for an id.

include adds optional blocks: goods_services, previous_parties, assignments (adds assignments and securities) and source_record.
The response carries a weak ETag and Cache-Control: private, no-cache. Send the ETag back in If-None-Match to get 304 Not Modified when the record has not changed. See Caching.
A malformed id gets 400 invalid-request; an unknown id gets 404 not-found; a record in a register that is reloading gets 503 jurisdiction-unavailable.

curl "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba" \
  -H "Authorization: Bearer $PINAKEL_API_KEY"

import os

import requests

tm_id = "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
resp = requests.get(
    f"https://api.pinakelai.com/v1/trademarks/{tm_id}",
    headers={"Authorization": f"Bearer {os.environ['PINAKEL_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
record, etag = resp.json(), resp.headers["ETag"]

const id = "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba";
const res = await fetch(`https://api.pinakelai.com/v1/trademarks/${id}`, {
  headers: { Authorization: `Bearer ${process.env.PINAKEL_API_KEY}` },
});
const record = await res.json();
const etag = res.headers.get("ETag");

{
  "object": "trademark",
  "id": "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba",
  "jurisdiction": "AD",
  "office": "AD",
  "origin_office": null,
  "identifiers": {
    "application_number": "48000",
    "registration_number": "48000",
    "international_registration_numbers": [],
    "priority_claims": []
  },
  "mark": {
    "text": "NOKY",
    "translation": null,
    "transliteration": null,
    "feature": "word",
    "kind": "individual"
  },
  "status": {
    "value": "registered",
    "category": "live",
    "date": "2009-06-05",
    "office_status": null,
    "office_status_code": null
  },
  "dates": {
    "application": "2009-06-05",
    "registration": "2009-06-05",
    "publication": "2025-07-28",
    "expiry": "2029-06-05",
    "renewal": null,
    "termination": null,
    "opposition_period_end": null
  },
  "classification": {
    "nice_classes": [8, 16, 21],
    "national_classes": [],
    "similar_group_codes": [],
    "vienna_codes": []
  },
  "parties": {
    "owners": [
      {
        "name": "ESSITY PLD FRANCE SAS",
        "name_translated": null,
        "name_key": "ESSITY PLD FRANCE",
        "country": null,
        "address": "BOULEVARD VICTOR-HUGO, CS 80047, 151, POSTAL CODE: 93400, CITY: SAINT-OUEN, FRANCE",
        "entity": "SAS",
        "roles": ["owner", "applicant"]
      }
    ],
    "representatives": [
      {
        "name": "JOSEP CARBONELL GIMENO",
        "name_translated": null,
        "name_key": "JOSEP CARBONELL GIMENO",
        "country": "AD",
        "address": "C. Bonaventura Riberaygua, 39, 4t - 3a Andorra la Vella",
        "entity": null,
        "roles": ["representative"]
      }
    ]
  },
  "designated_countries": [],
  "media": {
    "has_image": false
  },
  "updated_at": "2026-11-10T09:02:13.512000Z",
  "source": {
    "processed_on": "2026-11-10"
  },
  "links": {
    "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
  }
}

{
  "type": "https://docs.pinakelai.com/errors/not-found",
  "title": "Not found",
  "status": 404,
  "detail": "No trademark with id tm_AD_no-such-record.",
  "request_id": "req_01M7Q41C4D5E6F7G8H9J0K1M2N"
}

{
  "type": "https://docs.pinakelai.com/errors/jurisdiction-unavailable",
  "title": "Jurisdiction unavailable",
  "status": 503,
  "detail": "Register AD is being reloaded.",
  "request_id": "req_01M7Q41D5E6F7G8H9J0K1M2N3P"
}

Authorizations

Authorization

string

header

required

Your API key: Authorization: Bearer pk_live_... (or pk_test_...).

Path Parameters

string

required

Trademark id as returned in id: tm__.

Query Parameters

include

enum<string>[]

Optional parts: goods_services, previous_parties, assignments (with securities), source_record (the office record as stored, outside the stability guarantee). Repeat or separate with commas.

Available options:

goods_services,

previous_parties,

assignments,

source_record

Response

Successful Response

The trademark object (plan 1.9). Include fields appear only when asked.

object

string

required

Allowed value: "trademark"

string

required

jurisdiction

string

required

office

string | null

required

origin_office

string | null

required

identifiers

Identifiers · object

required

Show child attributes

mark

Mark · object

required

Show child attributes

status

Status · object

required

Show child attributes

dates

Dates · object

required

Show child attributes

classification

Classification · object

required

Show child attributes

parties

Parties · object

required

Show child attributes

designated_countries

string[]

required

media

Media · object

required

Show child attributes

updated_at

string

required

source

Source · object

required

Show child attributes

links

Links · object

required

Show child attributes

goods_services

GoodsServicesEntry · object[] | null

Only with include=goods_services.

Show child attributes

previous_parties

Parties · object | null

Only with include=previous_parties.

Show child attributes

assignments

Assignments · object[] | null

Only with include=assignments.

securities

Securities · object[] | null

Only with include=assignments.

source_record

Source Record · object | null

Only with include=source_record; not covered by the stability guarantee.

Overview

Trademarks

Changes

Jurisdictions

Account

Authorizations

Path Parameters

Query Parameters

Response