Search trademarks

curl -G "https://api.pinakelai.com/v1/trademarks" \
  -H "Authorization: Bearer $PINAKEL_API_KEY" \
  --data-urlencode "jurisdiction=AD" \
  --data-urlencode "number=48000,48003" \
  --data-urlencode "include_total=true"

import os

import requests

resp = requests.get(
    "https://api.pinakelai.com/v1/trademarks",
    headers={"Authorization": f"Bearer {os.environ['PINAKEL_API_KEY']}"},
    params={"jurisdiction": "AD", "number": "48000,48003", "include_total": "true"},
    timeout=30,
)
resp.raise_for_status()
page = resp.json()

const params = new URLSearchParams({
  jurisdiction: "AD",
  number: "48000,48003",
  include_total: "true",
});
const res = await fetch(`https://api.pinakelai.com/v1/trademarks?${params}`, {
  headers: { Authorization: `Bearer ${process.env.PINAKEL_API_KEY}` },
});
const page = await res.json();

{
  "object": "list",
  "data": [
    {
      "object": "trademark_summary",
      "id": "tm_AD_097c8a54-c1a8-5a8e-8b77-fb1b9e51ccba",
      "jurisdiction": "AD",
      "office": "AD",
      "origin_office": null,
      "identifiers": {
        "application_number": "48003",
        "registration_number": "48003"
      },
      "mark": {
        "text": "SkingénIA by GALENIC",
        "translation": null,
        "transliteration": null,
        "feature": "word",
        "kind": "individual"
      },
      "status": {
        "value": "registered",
        "category": "live",
        "date": "2020-06-23"
      },
      "dates": {
        "application": "2020-06-23",
        "registration": "2020-06-23",
        "publication": "2025-07-30",
        "expiry": "2030-06-23",
        "renewal": null,
        "termination": null,
        "opposition_period_end": null
      },
      "primary_owner": {
        "name": "GALENIC COSMETICS LABORATORY",
        "country": null
      },
      "owner_count": 1,
      "nice_class_count": 1,
      "primary_nice_class": 9,
      "media": {
        "has_image": false
      },
      "updated_at": "2026-11-10T09:02:13.498211Z",
      "links": {
        "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_097c8a54-c1a8-5a8e-8b77-fb1b9e51ccba"
      }
    },
    {
      "object": "trademark_summary",
      "id": "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba",
      "jurisdiction": "AD",
      "office": "AD",
      "origin_office": null,
      "identifiers": {
        "application_number": "48000",
        "registration_number": "48000"
      },
      "mark": {
        "text": "NOKY",
        "translation": null,
        "transliteration": null,
        "feature": "word",
        "kind": "individual"
      },
      "status": {
        "value": "registered",
        "category": "live",
        "date": "2009-06-05"
      },
      "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
      },
      "primary_owner": {
        "name": "ESSITY PLD FRANCE SAS",
        "country": null
      },
      "owner_count": 1,
      "nice_class_count": 3,
      "primary_nice_class": 8,
      "media": {
        "has_image": false
      },
      "updated_at": "2026-11-10T09:02:13.512000Z",
      "links": {
        "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
      }
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "unavailable_jurisdictions": [],
  "total": {
    "value": 2,
    "relation": "eq"
  }
}

{
  "type": "https://docs.pinakelai.com/errors/invalid-request",
  "title": "Invalid request",
  "status": 400,
  "detail": "The request has invalid parameters; see errors.",
  "request_id": "req_01M7Q41A2B3C4D5E6F7G8H9J0K",
  "errors": [
    {
      "code": "invalid-parameter",
      "detail": "owner_key needs jurisdiction with at most 5 codes.",
      "parameter": "owner_key"
    }
  ]
}

{
  "type": "https://docs.pinakelai.com/errors/query-too-broad",
  "title": "Query too broad",
  "status": 422,
  "detail": "mark_text_phrase matches more than 100,000 records. Narrow the search.",
  "request_id": "req_01M7Q41B3C4D5E6F7G8H9J0K1M"
}

GET

trademarks

curl -G "https://api.pinakelai.com/v1/trademarks" \
  -H "Authorization: Bearer $PINAKEL_API_KEY" \
  --data-urlencode "jurisdiction=AD" \
  --data-urlencode "number=48000,48003" \
  --data-urlencode "include_total=true"

import os

import requests

resp = requests.get(
    "https://api.pinakelai.com/v1/trademarks",
    headers={"Authorization": f"Bearer {os.environ['PINAKEL_API_KEY']}"},
    params={"jurisdiction": "AD", "number": "48000,48003", "include_total": "true"},
    timeout=30,
)
resp.raise_for_status()
page = resp.json()

const params = new URLSearchParams({
  jurisdiction: "AD",
  number: "48000,48003",
  include_total: "true",
});
const res = await fetch(`https://api.pinakelai.com/v1/trademarks?${params}`, {
  headers: { Authorization: `Bearer ${process.env.PINAKEL_API_KEY}` },
});
const page = await res.json();

{
  "object": "list",
  "data": [
    {
      "object": "trademark_summary",
      "id": "tm_AD_097c8a54-c1a8-5a8e-8b77-fb1b9e51ccba",
      "jurisdiction": "AD",
      "office": "AD",
      "origin_office": null,
      "identifiers": {
        "application_number": "48003",
        "registration_number": "48003"
      },
      "mark": {
        "text": "SkingénIA by GALENIC",
        "translation": null,
        "transliteration": null,
        "feature": "word",
        "kind": "individual"
      },
      "status": {
        "value": "registered",
        "category": "live",
        "date": "2020-06-23"
      },
      "dates": {
        "application": "2020-06-23",
        "registration": "2020-06-23",
        "publication": "2025-07-30",
        "expiry": "2030-06-23",
        "renewal": null,
        "termination": null,
        "opposition_period_end": null
      },
      "primary_owner": {
        "name": "GALENIC COSMETICS LABORATORY",
        "country": null
      },
      "owner_count": 1,
      "nice_class_count": 1,
      "primary_nice_class": 9,
      "media": {
        "has_image": false
      },
      "updated_at": "2026-11-10T09:02:13.498211Z",
      "links": {
        "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_097c8a54-c1a8-5a8e-8b77-fb1b9e51ccba"
      }
    },
    {
      "object": "trademark_summary",
      "id": "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba",
      "jurisdiction": "AD",
      "office": "AD",
      "origin_office": null,
      "identifiers": {
        "application_number": "48000",
        "registration_number": "48000"
      },
      "mark": {
        "text": "NOKY",
        "translation": null,
        "transliteration": null,
        "feature": "word",
        "kind": "individual"
      },
      "status": {
        "value": "registered",
        "category": "live",
        "date": "2009-06-05"
      },
      "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
      },
      "primary_owner": {
        "name": "ESSITY PLD FRANCE SAS",
        "country": null
      },
      "owner_count": 1,
      "nice_class_count": 3,
      "primary_nice_class": 8,
      "media": {
        "has_image": false
      },
      "updated_at": "2026-11-10T09:02:13.512000Z",
      "links": {
        "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
      }
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "unavailable_jurisdictions": [],
  "total": {
    "value": 2,
    "relation": "eq"
  }
}

{
  "type": "https://docs.pinakelai.com/errors/invalid-request",
  "title": "Invalid request",
  "status": 400,
  "detail": "The request has invalid parameters; see errors.",
  "request_id": "req_01M7Q41A2B3C4D5E6F7G8H9J0K",
  "errors": [
    {
      "code": "invalid-parameter",
      "detail": "owner_key needs jurisdiction with at most 5 codes.",
      "parameter": "owner_key"
    }
  ]
}

{
  "type": "https://docs.pinakelai.com/errors/query-too-broad",
  "title": "Query too broad",
  "status": 422,
  "detail": "mark_text_phrase matches more than 100,000 records. Narrow the search.",
  "request_id": "req_01M7Q41B3C4D5E6F7G8H9J0K1M"
}

Search every available register with structured filters. Returns a page of summaries, newest filing first.

Different parameters are combined with AND. Several values of one parameter, repeated or comma-separated, are combined with OR.
At least one filter is required; jurisdiction counts. Without jurisdiction, every available register is searched.
owner_*, representative_*, previous_owner_* and the party phrase filters need jurisdiction with at most 5 codes.
Phrase filters take one value of 1 to 200 characters. goods_services_phrase is not available in v1.
include=full returns full trademark objects instead of summaries, with limit of at most 25.
To get the next page, send the same filters and sort with cursor set to next_cursor.

Searching explains every filter, anchored and broad searches, sorting and totals.

curl -G "https://api.pinakelai.com/v1/trademarks" \
  -H "Authorization: Bearer $PINAKEL_API_KEY" \
  --data-urlencode "jurisdiction=AD" \
  --data-urlencode "number=48000,48003" \
  --data-urlencode "include_total=true"

import os

import requests

resp = requests.get(
    "https://api.pinakelai.com/v1/trademarks",
    headers={"Authorization": f"Bearer {os.environ['PINAKEL_API_KEY']}"},
    params={"jurisdiction": "AD", "number": "48000,48003", "include_total": "true"},
    timeout=30,
)
resp.raise_for_status()
page = resp.json()

const params = new URLSearchParams({
  jurisdiction: "AD",
  number: "48000,48003",
  include_total: "true",
});
const res = await fetch(`https://api.pinakelai.com/v1/trademarks?${params}`, {
  headers: { Authorization: `Bearer ${process.env.PINAKEL_API_KEY}` },
});
const page = await res.json();

{
  "object": "list",
  "data": [
    {
      "object": "trademark_summary",
      "id": "tm_AD_097c8a54-c1a8-5a8e-8b77-fb1b9e51ccba",
      "jurisdiction": "AD",
      "office": "AD",
      "origin_office": null,
      "identifiers": {
        "application_number": "48003",
        "registration_number": "48003"
      },
      "mark": {
        "text": "SkingénIA by GALENIC",
        "translation": null,
        "transliteration": null,
        "feature": "word",
        "kind": "individual"
      },
      "status": {
        "value": "registered",
        "category": "live",
        "date": "2020-06-23"
      },
      "dates": {
        "application": "2020-06-23",
        "registration": "2020-06-23",
        "publication": "2025-07-30",
        "expiry": "2030-06-23",
        "renewal": null,
        "termination": null,
        "opposition_period_end": null
      },
      "primary_owner": {
        "name": "GALENIC COSMETICS LABORATORY",
        "country": null
      },
      "owner_count": 1,
      "nice_class_count": 1,
      "primary_nice_class": 9,
      "media": {
        "has_image": false
      },
      "updated_at": "2026-11-10T09:02:13.498211Z",
      "links": {
        "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_097c8a54-c1a8-5a8e-8b77-fb1b9e51ccba"
      }
    },
    {
      "object": "trademark_summary",
      "id": "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba",
      "jurisdiction": "AD",
      "office": "AD",
      "origin_office": null,
      "identifiers": {
        "application_number": "48000",
        "registration_number": "48000"
      },
      "mark": {
        "text": "NOKY",
        "translation": null,
        "transliteration": null,
        "feature": "word",
        "kind": "individual"
      },
      "status": {
        "value": "registered",
        "category": "live",
        "date": "2009-06-05"
      },
      "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
      },
      "primary_owner": {
        "name": "ESSITY PLD FRANCE SAS",
        "country": null
      },
      "owner_count": 1,
      "nice_class_count": 3,
      "primary_nice_class": 8,
      "media": {
        "has_image": false
      },
      "updated_at": "2026-11-10T09:02:13.512000Z",
      "links": {
        "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
      }
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "unavailable_jurisdictions": [],
  "total": {
    "value": 2,
    "relation": "eq"
  }
}

{
  "type": "https://docs.pinakelai.com/errors/invalid-request",
  "title": "Invalid request",
  "status": 400,
  "detail": "The request has invalid parameters; see errors.",
  "request_id": "req_01M7Q41A2B3C4D5E6F7G8H9J0K",
  "errors": [
    {
      "code": "invalid-parameter",
      "detail": "owner_key needs jurisdiction with at most 5 codes.",
      "parameter": "owner_key"
    }
  ]
}

{
  "type": "https://docs.pinakelai.com/errors/query-too-broad",
  "title": "Query too broad",
  "status": 422,
  "detail": "mark_text_phrase matches more than 100,000 records. Narrow the search.",
  "request_id": "req_01M7Q41B3C4D5E6F7G8H9J0K1M"
}

Authorizations

Authorization

string

header

required

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

Query Parameters

jurisdiction

string[]

Registers to search, as listed by GET /v1/jurisdictions (e.g. CH, US, EM, WO). Repeat the parameter or separate values with commas (OR), up to 20. Default: every available register.

application_number

string[]

Exact application number in the office's format, e.g. VA 2026 00923. Matched as sent, upper-cased, and upper-cased without spaces, so letter case and extra spaces do not matter; keep the office's own spacing and punctuation. Repeat the parameter for several values (OR), up to 100.

registration_number

string[]

Exact registration number in the office's format. Matched as sent, upper-cased, and upper-cased without spaces, so letter case and extra spaces do not matter; keep the office's own spacing and punctuation. Repeat the parameter for several values (OR), up to 100.

number

string[]

Matches either the application or the registration number. Matched as sent, upper-cased, and upper-cased without spaces, so letter case and extra spaces do not matter; keep the office's own spacing and punctuation. Repeat the parameter for several values (OR), up to 100.

international_registration_number

string[]

Madrid international registration number, in national registers and WIPO's. Matched as sent, upper-cased, and upper-cased without spaces, so letter case and extra spaces do not matter; keep the office's own spacing and punctuation. Without a number or mark_text filter, at most 1,000 records may match (else 422 query-too-broad). Repeat the parameter for several values (OR), up to 20.

priority_number

string[]

Number of a claimed priority application. Matched as sent, upper-cased, and upper-cased without spaces, so letter case and extra spaces do not matter; keep the office's own spacing and punctuation. Without a number or mark_text filter, at most 1,000 records may match (else 422 query-too-broad). Repeat the parameter for several values (OR), up to 20.

mark_text

string[]

Exact mark text, compared after the normalization stored names get (case, accents, punctuation and trailing legal forms are ignored). Repeat the parameter for several values (OR), up to 20.

mark_text_phrase

string

Phrase in the mark text, its translation or transliteration: Latin and Cyrillic match whole words in order, CJK the exact character sequence. No substring search.

Required string length: 1 - 200

primary_owner_name

string[]

Exact name of the first-listed owner (normalized like mark_text); fast in any scope. Repeat for several values: primary_owner_name and primary_owner_key are one filter, and all their values are combined with OR, up to 20 together.

primary_owner_key

string[]

A stored owner name key (a party's name_key), matched verbatim against the first-listed owner. Repeat for several values: primary_owner_name and primary_owner_key are one filter, and all their values are combined with OR, up to 20 together.

owner_name

string[]

Exact name of any current owner, holder or applicant (normalized). Needs jurisdiction with 1 to 5 registers. Repeat for several values: owner_name and owner_key are one filter, and all their values are combined with OR, up to 20 together.

owner_key

string[]

A stored name_key of any current owner, holder or applicant, verbatim. Needs jurisdiction with 1 to 5 registers. Repeat for several values: owner_name and owner_key are one filter, and all their values are combined with OR, up to 20 together.

representative_name

string[]

Exact name of a current representative or correspondent (normalized). Needs jurisdiction with 1 to 5 registers. Repeat for several values: representative_name and representative_key are one filter, and all their values are combined with OR, up to 20 together.

representative_key

string[]

A stored name_key of a current representative or correspondent, verbatim. Needs jurisdiction with 1 to 5 registers. Repeat for several values: representative_name and representative_key are one filter, and all their values are combined with OR, up to 20 together.

previous_owner_name

string[]

Exact name of a previous owner or holder (normalized). Needs jurisdiction with 1 to 5 registers. Repeat for several values: previous_owner_name and previous_owner_key are one filter, and all their values are combined with OR, up to 20 together.

previous_owner_key

string[]

A stored name_key of a previous owner or holder, verbatim. Needs jurisdiction with 1 to 5 registers. Repeat for several values: previous_owner_name and previous_owner_key are one filter, and all their values are combined with OR, up to 20 together.

owner_name_phrase

string

Phrase in the names of current owners, holders and applicants. Needs jurisdiction with 1 to 5 registers.

Required string length: 1 - 200

representative_name_phrase

string

Phrase in the names of current representatives and correspondents. Needs jurisdiction with 1 to 5 registers.

Required string length: 1 - 200

goods_services_phrase

string

Reserved: goods and services phrase search is not available yet (400 invalid-request, code not-yet-available).

office

string[]

Registering office; WIPO's register reports WO. Repeat the parameter or separate values with commas (OR), up to 20.

origin_office

string[]

Office of origin of an international registration (WIPO's register). Repeat the parameter or separate values with commas (OR), up to 20.

status

enum<string>[]

Status value; other = a status outside this list, unknown = the office says unknown, none = not stated. Repeat the parameter or separate values with commas (OR), up to 20.

Available options:

registered,

pending,

abandoned,

cancelled,

expired,

unknown,

other,

none

status_category

enum<string>[]

live, dead or unknown; none = not stated. Repeat the parameter or separate values with commas (OR), up to 20.

Available options:

live,

dead,

unknown,

none

mark_feature

enum<string>[]

Mark feature; other = a value outside this list, none = not stated. Repeat the parameter or separate values with commas (OR), up to 20.

Available options:

word,

figurative,

combined,

three_dimensional,

colour,

combination_of_colours,

sound,

hologram,

olfactory,

motion,

multimedia,

position,

pattern,

touch,

taste,

stylized_characters,

other,

none

mark_kind

enum<string>[]

Kind of mark; other = a value outside this list, none = not stated. Repeat the parameter or separate values with commas (OR), up to 20.

Available options:

individual,

collective,

certificate,

guarantee,

defensive,

geographical,

common_right,

logotype,

service,

trademark,

denomination,

other,

none

has_image

boolean

true: only records with a mark image; false: only records without.

primary_owner_country

string[]

ISO 3166-1 alpha-2 country of the first-listed owner. Repeat the parameter or separate values with commas (OR), up to 20.

nice_class

integer[]

Nice class, 1 to 45; a record matches if it lists any of them. Repeat the parameter or separate values with commas (OR), up to 20.

similar_group_code

string[]

Similar-group code (CN, KR). Repeat the parameter or separate values with commas (OR), up to 20.

vienna_code

string[]

Vienna code: 27.05.01 matches exactly; 27 or 27.05 matches the codes under it and needs jurisdiction, nice_class or primary_owner_country too. Repeat the parameter or separate values with commas (OR), up to 20.

designated_country

string[]

ISO 3166-1 alpha-2 country designated by an international registration. Repeat the parameter or separate values with commas (OR), up to 20.

application_date_from

string<date>

Earliest application date, YYYY-MM-DD, inclusive.

application_date_to

string<date>

Latest application date, YYYY-MM-DD, inclusive.

registration_date_from

string<date>

Earliest registration date, YYYY-MM-DD, inclusive.

registration_date_to

string<date>

Latest registration date, YYYY-MM-DD, inclusive.

publication_date_from

string<date>

Earliest publication date, YYYY-MM-DD, inclusive.

publication_date_to

string<date>

Latest publication date, YYYY-MM-DD, inclusive.

expiry_date_from

string<date>

Earliest expiry date, YYYY-MM-DD, inclusive.

expiry_date_to

string<date>

Latest expiry date, YYYY-MM-DD, inclusive.

renewal_date_from

string<date>

Earliest renewal date, YYYY-MM-DD, inclusive.

renewal_date_to

string<date>

Latest renewal date, YYYY-MM-DD, inclusive.

termination_date_from

string<date>

Earliest termination date, YYYY-MM-DD, inclusive.

termination_date_to

string<date>

Latest termination date, YYYY-MM-DD, inclusive.

opposition_period_end_date_from

string<date>

Earliest opposition period end date, YYYY-MM-DD, inclusive.

opposition_period_end_date_to

string<date>

Latest opposition period end date, YYYY-MM-DD, inclusive.

status_date_from

string<date>

Earliest status date, YYYY-MM-DD, inclusive.

status_date_to

string<date>

Latest status date, YYYY-MM-DD, inclusive.

sort

enum<string>

default:-application_date

-application_date (newest first, the default) or application_date. registration_date and expiry_date, either direction, need an anchor filter (a number, name, key or phrase). Undated records come last.

Available options:

-application_date,

application_date,

-registration_date,

registration_date,

-expiry_date,

expiry_date

limit

integer

default:25

Items per page, 1 to 100 (default 25; at most 25 with include=full). Pages can be short, even empty, while has_more is true.

Required range: 1 <= x <= 100

include

string[]

full: return full trademark objects instead of summaries (limit at most 25).

Allowed value: "full"

include_total

boolean

default:false

true: add total {value, relation}; computed on the first page and carried in the cursor.

cursor

string

next_cursor of the previous page. Send it with the same filters and sort; limit, include and include_total may change.

Maximum string length: 6000

Response

Successful Response

object

string

required

Allowed value: "list"

data

(TrademarkSummary · object | Trademark · object)[]

required

Search and feed item built from the core row only (plan 0). Ask include=full (limit <= 25) for full trademark objects.

TrademarkSummary
Trademark

Show child attributes

has_more

boolean

required

next_cursor

string | null

required

unavailable_jurisdictions

string[]

required

search_progress

SearchProgress · object | null

Show child attributes

total

TotalDocument · object | null

Show child attributes

Overview

Trademarks

Changes

Jurisdictions

Account

Authorizations

Query Parameters

Response