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

# List Classifications

> List all Nice classification classes with descriptions

## Overview

Returns the complete Nice Classification system used to categorize goods and services in trademark applications. Each class includes its number, title, and description. The Nice Classification is maintained by WIPO and updated annually; Signa always reflects the current edition.

This reference endpoint is useful for building class pickers, validating user input, and displaying human-readable class descriptions alongside trademark data.

## Query Parameters

<ParamField query="type" type="string">
  Filter by classification type: `goods` (classes 1-34) or `services` (classes 35-45)
</ParamField>

## Response

<ResponseField name="data" type="object[]">
  <Expandable title="Classification object">
    <ResponseField name="class_number" type="integer">Nice class number (1-45)</ResponseField>
    <ResponseField name="title" type="string">Official Nice class heading — the full title string published by WIPO, typically a comma/semicolon-separated list of the kinds of goods or services the class covers</ResponseField>
    <ResponseField name="category" type="string">`goods` (classes 1-34) or `services` (classes 35-45)</ResponseField>
    <ResponseField name="description" type="string">Full Nice class scope description</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "object": "list",
    "data": [
      {
        "class_number": 9,
        "object": "classification",
        "title": "Scientific, research, navigation, surveying, photographic, cinematographic, audiovisual, optical, weighing, measuring, signalling, detecting, testing, inspecting, life-saving and teaching apparatus and instruments; apparatus and instruments for conducting, switching, transforming, accumulating, regulating or controlling the distribution or use of electricity; apparatus and instruments for recording, transmitting, reproducing or processing sound, images or data; recorded and downloadable media, computer software, blank digital or analogue recording and storage media",
        "description": "Scientific, research, navigation, surveying, photographic, cinematographic, audiovisual, optical, weighing, measuring, signalling, detecting, testing, inspecting, life-saving and teaching apparatus and instruments; apparatus and instruments for conducting, switching, transforming, accumulating, regulating or controlling the distribution or use of electricity; apparatus and instruments for recording, transmitting, reproducing or processing sound, images or data; recorded and downloadable media, computer software, blank digital or analogue recording and storage media.",
        "category": "goods"
      },
      {
        "class_number": 35,
        "object": "classification",
        "title": "Advertising; business management, organization and administration; office functions",
        "description": "Advertising; business management, organization and administration; office functions.",
        "category": "services"
      }
    ],
    "has_more": false,
    "pagination": {
      "cursor": null
    },
    "request_id": "req_qJ6aB2cD"
  }
  ```
</ResponseExample>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/classifications?type=services" \
    -H "Authorization: Bearer sig_xxxxxxxxxxxx"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";

  const signa = new Signa({ api_key: "sig_xxxxxxxxxxxx" });

  const classifications = await signa.references.classifications({
    type: "services",
  });
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://api.signa.so/v1/classifications",
      headers={"Authorization": "Bearer sig_xxxxxxxxxxxx"},
      params={"type": "services"},
  )
  classes = resp.json()["data"]
  ```
</CodeGroup>

## Errors

| Status | Type               | Description                |
| ------ | ------------------ | -------------------------- |
| 400    | `validation_error` | Invalid `type` parameter   |
| 401    | `unauthorized`     | Missing or invalid API key |
| 429    | `rate_limited`     | Too many requests          |

## Related Endpoints

* [Get Classification](/api-reference/reference/get-classification) -- single class detail
* [Suggest Classifications](/api-reference/reference/suggest-classifications) -- AI-assisted class suggestion from a description
* [Suggest Goods & Services](/api-reference/reference/suggest-goods-services) -- draft filing-ready wording per class
* [List Goods & Services](/api-reference/reference/list-goods-services) -- browse/search the pre-approved term catalog
* [List Trademarks](/api-reference/trademarks/list-trademarks) -- filter or search by Nice class
