> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinakelai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://docs.pinakelai.com/guides/versioning.md).

**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](https://docs.pinakelai.com/api-reference/trademarks/search.md), [retrieve](https://docs.pinakelai.com/api-reference/trademarks/retrieve.md), [batch retrieve](https://docs.pinakelai.com/api-reference/trademarks/batch.md) of up to 100 records, the [changes feed](https://docs.pinakelai.com/api-reference/changes/list.md), [jurisdictions](https://docs.pinakelai.com/api-reference/jurisdictions/list.md) with coverage and freshness, [usage](https://docs.pinakelai.com/api-reference/account/usage.md) and [health](https://docs.pinakelai.com/api-reference/account/health.md).
* **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](https://docs.pinakelai.com/guides/syncing.md).
* **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`](https://docs.pinakelai.com/errors/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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.