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

<ParamField query="q" type="string">
  Search classification titles, descriptions, and terms (case-insensitive contains, max 200 characters).
</ParamField>

<ParamField query="limit" type="integer" default="100">
  Max results per page (max 500). The default returns all 45 classes in one page.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor from `pagination.cursor` of the previous page.
</ParamField>

## Response

This endpoint is publicly cacheable, so the response never includes `request_id`.

<ResponseField name="object" type="string">Always `list`.</ResponseField>

<ResponseField name="data" type="object[]">
  <Expandable title="Classification object">
    <ResponseField name="class_number" type="integer">Nice class number (1-45)</ResponseField>
    <ResponseField name="object" type="string">Always `classification`</ResponseField>
    <ResponseField name="title" type="string">Official Nice class heading, the full title string published by WIPO</ResponseField>
    <ResponseField name="description" type="string">Full Nice class scope description</ResponseField>
    <ResponseField name="category" type="string">`goods` (classes 1-34) or `services` (classes 35-45)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="has_more" type="boolean">Whether more pages are available.</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Pagination">
    <ResponseField name="cursor" type="string | null">Cursor for the next page, or `null` on the last page.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "object": "list",
    "data": [
      {
        "class_number": 25,
        "object": "classification",
        "title": "Clothing, footwear, headwear",
        "description": "Clothing, footwear, headwear",
        "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
    }
  }
  ```
</ResponseExample>

## Code Examples

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

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

  const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

  const classifications = await signa.references.classifications({ q: "software" });
  ```
</CodeGroup>

## Errors

| Status | Type               | Description                           |
| ------ | ------------------ | ------------------------------------- |
| 400    | `validation_error` | Invalid `type` parameter              |
| 401    | `unauthorized`     | Missing or invalid API key            |
| 403    | `forbidden`        | API key lacks `trademarks:read` scope |
| 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 and search the pre-approved term catalog
* [List Trademarks](/api-reference/trademarks/list-trademarks), filter or search by Nice class