Skip to main content
GET
/
v1
/
design-codes
List Design Codes
curl --request GET \
  --url https://api.example.com/v1/design-codes
{
  "object": "list",
  "data": [
    {
      "code": "03.05.01",
      "object": "design_code",
      "category": "03",
      "division": "05",
      "section": "01",
      "depth": 3,
      "description": "Lions"
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "03.05.01" },
  "livemode": true,
  "request_id": "req_xyz"
}

​
Overview

Lists Vienna classification design codes used to describe figurative elements in trademarks. Filter by depth (1=category, 2=division, 3=section) or search descriptions. Use this to build Vienna code pickers for image search interfaces.

​
Query Parameters

​
q
string
Substring search across descriptions (case-insensitive, max 200 chars).
​
depth
integer
Filter by depth: 1 (category), 2 (division), or 3 (section).
​
category
string
Two-digit category code filter (e.g. 03).
​
limit
integer
default:"100"
Max results (1-500).
​
cursor
string
Pagination cursor (the code of the last item returned).

​
Response

​
data
object[]
Array of Vienna code records ordered by code.
​
data[].code
string
Vienna code (e.g. 03, 03.05, 03.05.01).
​
data[].object
string
Always design_code.
​
data[].category
string
Two-digit category prefix.
​
data[].division
string
Division code, when applicable.
​
data[].section
string
Section code, when applicable.
​
data[].depth
integer
Depth (1, 2, or 3).
​
data[].description
string
Description text.
{
  "object": "list",
  "data": [
    {
      "code": "03.05.01",
      "object": "design_code",
      "category": "03",
      "division": "05",
      "section": "01",
      "depth": 3,
      "description": "Lions"
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "03.05.01" },
  "livemode": true,
  "request_id": "req_xyz"
}

​
Code Examples

curl -G "https://api.signa.so/v1/design-codes" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE" \
  --data-urlencode "q=lion" \
  --data-urlencode "depth=3" \
  --data-urlencode "limit=20"

​
Errors

StatusTypeDescription
400validation_errorInvalid depth or query length
401unauthorizedMissing or invalid API key