Skip to main content
GET
/
v1
/
classifications
/
{class_number}
/
terms
Classification Terms
curl --request GET \
  --url https://api.example.com/v1/classifications/{class_number}/terms
{
  "object": "list",
  "data": [
    {
      "term": "downloadable mobile applications",
      "term_key": "tmc_downloadable_mobile_applications",
      "taxonomy_path": "Goods > Class 9 > Software",
      "is_harmonised": true,
      "accepted_offices": ["uspto", "euipo", "wipo", "cipo"],
      "source": "tmclass",
      "language": "en"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "livemode": true,
  "request_id": "req_xyz"
}

​
Overview

Searches the harmonised goods and services term database (sourced from TMClass and per-office accepted lists) for a single Nice class. Use this to power goods/services autocomplete in filing tools or to verify whether a proposed term is harmonised across offices.

​
Path Parameters

​
class_number
integer
required
Nice class number (1-45).

​
Query Parameters

​
q
string
required
Search query (2-200 characters). Substring match on the term text.
​
language
string
default:"en"
Language code (e.g. en, de, fr, es, it, ja).
​
harmonised_only
boolean
default:"false"
When true, only return terms accepted by all offices (TMClass harmonised list).
​
limit
integer
default:"20"
Max results (1-100).

​
Response

​
data
object[]
Array of term records ranked by best match.
​
data[].term
string
The term text.
​
data[].term_key
string
Stable identifier for the term.
​
data[].taxonomy_path
string
TMClass taxonomy path.
​
data[].is_harmonised
boolean
Whether the term is on the harmonised list.
​
data[].accepted_offices
string[]
Office codes that accept this term.
​
data[].source
string
Source database (e.g. tmclass).
​
data[].language
string
Language code.
{
  "object": "list",
  "data": [
    {
      "term": "downloadable mobile applications",
      "term_key": "tmc_downloadable_mobile_applications",
      "taxonomy_path": "Goods > Class 9 > Software",
      "is_harmonised": true,
      "accepted_offices": ["uspto", "euipo", "wipo", "cipo"],
      "source": "tmclass",
      "language": "en"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "livemode": true,
  "request_id": "req_xyz"
}

​
Code Examples

curl -G "https://api.signa.so/v1/classifications/9/terms" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE" \
  --data-urlencode "q=mobile applications" \
  --data-urlencode "harmonised_only=true" \
  --data-urlencode "limit=10"

​
Errors

StatusTypeDescription
400validation_errorq shorter than 2 characters or class number invalid
401unauthorizedMissing or invalid API key
404not_foundClass not loaded in reference data