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>'
import requests

url = "https://api.signa.so/v1/design-codes/{code}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.signa.so/v1/design-codes/{code}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.signa.so/v1/design-codes/{code}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.signa.so/v1/design-codes/{code}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.signa.so/v1/design-codes/{code}")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.signa.so/v1/design-codes/{code}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "code": "03.05",
  "object": "design_code",
  "category": "03",
  "division": "03.05",
  "section": null,
  "depth": 2,
  "description": "Quadrupeds (series V), quadrumana",
  "notes": null,
  "children": [
    { "code": "03.05.01", "description": "Rabbits, hares", "depth": 3 },
    { "code": "03.05.03", "description": "Squirrels", "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 at any depth: 03 (category), 03.05 (division), 03.05.01 (section). The undotted form (030501) and unpadded segments (3.5.1) are also accepted and normalized.

Response

This endpoint is publicly cacheable, so the response never includes request_id.
code
string
The requested Vienna code, normalized to the zero-padded dotted form.
object
string
Always design_code.
category
string
Two-digit category code (e.g. 03).
division
string | null
Division-level code (e.g. 03.05). null for depth-1 codes.
section
string | null
Section-level code (e.g. 03.05.01). null for depth-1 and depth-2 codes.
depth
integer
Depth (1, 2, or 3).
description
string
Description text.
notes
string | null
Additional Vienna notes when published by WIPO.
children
object[]
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": "03.05",
  "section": null,
  "depth": 2,
  "description": "Quadrupeds (series V), quadrumana",
  "notes": null,
  "children": [
    { "code": "03.05.01", "description": "Rabbits, hares", "depth": 3 },
    { "code": "03.05.03", "description": "Squirrels", "depth": 3 }
  ]
}

Code Examples

curl "https://api.signa.so/v1/design-codes/03.05" \
  -H "Authorization: Bearer sig_YOUR_KEY"
import { Signa } from "@signa-so/sdk";

const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

const code = await signa.references.designCode("03.05");

Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks trademarks:read scope
404not_foundVienna code does not exist