> ## 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.

# Introduction

> Search, retrieve and sync trademark records from national and regional registers through one API and one record model.

The Pinakel Trademark Data API serves trademark records from 119 national and regional registers, about 207 million records in all, in one record model. You can search by number, mark text, owner, representative, class and date, retrieve full records, and follow a changes feed to keep your own copy current.

It is built for docketing systems, IP management platforms, and in-house and law-firm tools that need register data in a predictable shape. Every register is mapped to the same fields, and the office's own wording is kept next to the mapped values.

## What are you building?

> [card] [Keep a docket in sync](https://docs.pinakelai.com/use-cases/docketing-sync.md)
>
> Match docket entries to register records and pick up status, date and owner changes.

> [card] [Watch a portfolio](https://docs.pinakelai.com/use-cases/portfolio-watch.md)
>
> Track every mark filed by a client, a competitor or your own firm.

> [card] [Pre-screen a new mark](https://docs.pinakelai.com/use-cases/clearance-pre-screen.md)
>
> Find identical and word-level conflicts before ordering a full search.

> [card] [Track renewals](https://docs.pinakelai.com/use-cases/renewal-tracking.md)
>
> List registered marks whose expiry date falls in a window you choose.

## The API at a glance

| | |
| - | - |
| Base URL | `https://api.pinakelai.com/v1` |
| Authentication | `Authorization: Bearer pk_live_…` (see [Authentication](https://docs.pinakelai.com/authentication.md)) |
| Format | JSON over HTTPS. Read-only: every endpoint is `GET`, except batch retrieve, which reads ids from a `POST` body. |
| Lists | `{"object": "list", "data": [...], "has_more": ..., "next_cursor": ...}` with [cursor pagination](https://docs.pinakelai.com/api-reference/pagination.md) |
| Errors | [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) problem details, `application/problem+json` (see [Errors](https://docs.pinakelai.com/api-reference/errors.md)) |
| Limits | Per-minute rate limit and monthly quota per key, reported in `RateLimit` headers (see [Rate limits & usage](https://docs.pinakelai.com/api-reference/rate-limits.md)) |
| Machine-readable spec | [`https://api.pinakelai.com/v1/openapi.json`](https://api.pinakelai.com/v1/openapi.json) (OpenAPI 3.1) |

Seven endpoints cover the whole product:

| Endpoint | What it does |
| - | - |
| [`GET /v1/trademarks`](https://docs.pinakelai.com/api-reference/trademarks/search) | Search with structured filters |
| [`GET /v1/trademarks/{id}`](https://docs.pinakelai.com/api-reference/trademarks/retrieve) | Retrieve one full record |
| [`POST /v1/trademarks/batch`](https://docs.pinakelai.com/api-reference/trademarks/batch) | Retrieve up to 100 full records by id |
| [`GET /v1/changes`](https://docs.pinakelai.com/api-reference/changes/list) | Follow every record change, in order |
| [`GET /v1/jurisdictions`](https://docs.pinakelai.com/api-reference/jurisdictions/list) | Coverage and freshness of every register |
| [`GET /v1/usage`](https://docs.pinakelai.com/api-reference/account/usage) | Your key's calls this month, quota and rate limit |
| [`GET /v1/health`](https://docs.pinakelai.com/api-reference/account/health) | Public service health check |

## Quick example

Find marks containing the word "noky" in the Andorran register:

```bash cURL theme={null}
curl -G "https://api.pinakelai.com/v1/trademarks" \
  -H "Authorization: Bearer $PINAKEL_API_KEY" \
  --data-urlencode "jurisdiction=AD" \
  --data-urlencode "mark_text_phrase=noky"
```

```json Response theme={null}
{
  "object": "list",
  "data": [
    {
      "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": []
}
```

Search results are summaries. Follow `links.self` (or call [retrieve](https://docs.pinakelai.com/api-reference/trademarks/retrieve.md)) for the full record with parties, classes and identifiers. The [Quickstart](https://docs.pinakelai.com/quickstart.md) walks through search, retrieve and sync in about ten minutes.

## Get started

> [card] [Quickstart](https://docs.pinakelai.com/quickstart.md)
>
> Search, retrieve a record, and subscribe to changes.

> [card] [Authentication](https://docs.pinakelai.com/authentication.md)
>
> Keys, the Bearer header, and test keys in the playground.

> [card] [The trademark record](https://docs.pinakelai.com/concepts/trademark-record.md)
>
> Every field, what `null` means, and what is stable.

> [card] [Coverage & freshness](https://docs.pinakelai.com/data/coverage-and-freshness.md)
>
> Which registers are served and how current each one is.


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