Skip to main content
GET
/
v1
/
design-codes
/
{code}
Get Design Code
curl --request GET \
  --url https://api.example.com/v1/design-codes/{code}
{
  "code": "03.05",
  "object": "design_code",
  "category": "03",
  "division": "05",
  "section": null,
  "depth": 2,
  "description": "Lions, tigers, leopards",
  "notes": null,
  "children": [
    { "code": "03.05.01", "description": "Lions", "depth": 3 },
    { "code": "03.05.02", "description": "Tigers", "depth": 3 }
  ]
}

​
Overview

Returns a single Vienna classification code along with any child codes at the next depth level. Use this when navigating the Vienna hierarchy interactively (e.g. drill down from 03 to 03.05 to 03.05.01).

​
Path Parameters

​
code
string
required
Vienna code (e.g. 03, 03.05, 03.05.01).

​
Response

​
code
string
The requested Vienna code.
​
object
string
Always design_code.
​
category
string
Two-digit category prefix.
​
division
string
Division code, when applicable.
​
section
string
Section code, when applicable.
​
depth
integer
Depth (1, 2, or 3).
​
description
string
Description text.
​
notes
string
Additional Vienna notes when published by WIPO.
​
children
object[]
Array of child codes at the next depth, each with code, description, and depth. Empty for depth 3 (leaf) codes.
{
  "code": "03.05",
  "object": "design_code",
  "category": "03",
  "division": "05",
  "section": null,
  "depth": 2,
  "description": "Lions, tigers, leopards",
  "notes": null,
  "children": [
    { "code": "03.05.01", "description": "Lions", "depth": 3 },
    { "code": "03.05.02", "description": "Tigers", "depth": 3 }
  ]
}

​
Code Examples

curl "https://api.signa.so/v1/design-codes/03.05" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
404not_foundVienna code does not exist