Skip to main content
GET
/
v1
/
design-codes
/
{code}
Get Design Code
curl --request GET \
  --url https://api.signa.so/v1/design-codes/{code} \
  --header 'Authorization: Bearer <token>'
{
  "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 }
  ]
}

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.

​
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_YOUR_KEY_HERE"

​
Errors

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