List Design Codes

List Vienna figurative classification codes for image searches

GET /v1/design-codes

List Design Codes

cURL

curl --request GET \
  --url https://api.signa.so/v1/design-codes \
  --header 'Authorization: Bearer <token>'

{
  "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" },
  "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" },
  "request_id": "req_xyz"
}

Code Examples

cURL

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

Errors

Status	Type	Description
400	validation_error	Invalid depth or query length
401	unauthorized	Missing or invalid API key

Related Endpoints

• Get Design Code — single code with children
• List Trademarks — search by vienna_codes