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

# Classification

> Nice classes, national classes, Chinese and Korean similar-group codes, Vienna codes, and goods and services text.

The `classification` block holds four lists. A class that fails one system's rules is routed to the right list, never dropped.

```json theme={null}
"classification": {
  "nice_classes": [9, 35, 36, 42],
  "national_classes": [],
  "similar_group_codes": [],
  "vienna_codes": []
}
```

## Nice classes

`nice_classes` holds Nice classes 1 to 45 as integers. Filter with `nice_class`; several values match records in **any** of the classes:

```bash theme={null}
--data-urlencode "nice_class=9,42"
```

Summaries carry `nice_class_count` and `primary_nice_class` (the first Nice class the office lists) instead of the full list.

## National classes

`national_classes` holds codes from a national classification that are not Nice classes, as strings and exactly as published, for example the letter classes of older United States records. There is no filter on national classes in v1.

## Similar-group codes (China and Korea)

The Chinese and Korean offices subdivide Nice classes into similar groups, and examiners compare goods by group rather than by class. In these registers the group codes are in `similar_group_codes`, for example `3501` (class 35, group 01) in the Chinese register. Other registers that publish similar-group codes use the same list.

Filter with `similar_group_code` (up to 20 values):

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

For a conflict pre-screen in China or Korea, filter on the similar groups of the goods you care about, not only the class.

## Vienna codes

`vienna_codes` holds the figurative elements of a mark under the Vienna Classification, as published, normally `category.division.section` such as `27.05.01`.

Filter with `vienna_code`:

* a full code, `27.05.01`, matches that code exactly;
* a one- or two-part prefix, `27` or `27.05`, matches every code under it. A prefix filter must be combined with `jurisdiction`, `nice_class` or `primary_owner_country`, otherwise the request gets 400 [`invalid-request`](https://docs.pinakelai.com/errors/invalid-request).

Offices publish Vienna codes in slightly different formats. If a prefix search returns nothing in a register you expect to have device marks, retrieve one of its records and check the stored format.

## Goods and services text

The full wording of the specification is not part of the default record. Add `include=goods_services` on [retrieve](https://docs.pinakelai.com/api-reference/trademarks/retrieve.md) or [batch retrieve](https://docs.pinakelai.com/api-reference/trademarks/batch.md) to get one entry per class:

```json theme={null}
"goods_services": [
  {
    "nice_class": 9,
    "class_code": "009",
    "language": "sq",
    "text": "Aplikacione softuerësh të shkarkueshëm (për programet e besnikërisë dhe të grumbullimit të pikëve).",
    "translation": "downloadable software applications (for loyalty and points-collecting programs)."
  }
]
```

* `nice_class` is the Nice class as an integer, or `null` for an entry filed under a national class; `class_code` is the class as stored.
* `language` is the language of `text` as the office states it.
* `translation` is a translation, usually into English, from the office or machine-translated by Pinakel. Use it to read and triage, not as the legal text.
* In the Chinese and Korean registers only the Nice-class entries are returned; similar-group detail stays in `similar_group_codes`.

Searching inside goods and services text is not available in v1. A request with `goods_services_phrase` gets 400 [`invalid-request`](https://docs.pinakelai.com/errors/invalid-request) with the error code `not-yet-available`.


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