Changelog

Changes to the Pinakel Trademark Data API and to these docs, newest first.

Every change that could affect an integration is listed here. Breaking changes do not happen within v1; see Versioning.

​

v1.0.0

Launch

​

Trademark Data API v1

The Data API is relaunched at https://api.pinakelai.com/v1, serving all 119 registers (about 207 million records) in one record model.

​

API

• Seven endpoints: search, retrieve, batch retrieve of up to 100 records, the changes feed, jurisdictions with coverage and freshness, usage and health.
• One record model for every register, with the office’s own status wording kept next to the normalized status. Search and the feed return summaries; retrieve and batch return full records.
• Search filters for numbers, international registration and priority numbers, exact and phrase matching on mark text and party names, owner and representative name keys, status, dates, Nice classes, Chinese and Korean similar groups, Vienna codes and designations.
• Changes feed with durable cursors. Its history starts at launch (feed_start); load your starting state with search, as described in Syncing.
• Standards: Authorization: Bearer keys, RFC 9457 problem details with a page per error type, draft-11 RateLimit headers, weak ETags on retrieve, and an OpenAPI 3.1 document at /v1/openapi.json.

​

Not in v1

• Searching goods and services text (goods_services_phrase returns 400 with the code not-yet-available).
• Substring, fuzzy and phonetic search.
• Mark images, opposition details, removal events in the feed, sparse fieldsets, and whole-register exports.
• OAuth access tokens. Bearer tokens that do not start with pk_ are reserved for them.

​

Moving from the earlier record API

The record API at /data/v1 is retired. Its paths answer 410 removed for at least six months.

Earlier API	v1
https://api.pinakelai.com/data/v1	https://api.pinakelai.com/v1
X-API-Key header	Authorization: Bearer
(jurisdiction_code, uid) identity	id, such as tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba
/v1/{code}/trademarks	jurisdiction filter
{"items": [...], "next_cursor": ...}	{"object": "list", "data": [...], "has_more": ..., "next_cursor": ...}
expand=payload	include on retrieve and batch
mark_name, kind_of_mark	mark_text, mark_kind
*_contains, *_startswith	Phrase filters; no substring search
updated_since, sort=updated_at	The changes feed
count=capped	include_total=true
{"error": {"code", "message", "param"}}	RFC 9457 problem details