Retrieve 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 }
]
}
Codes & types
Retrieve Design Code
Retrieve a single Vienna classification code with notes and child codes
GET
/
v1
/
design-codes
/
{code}
Retrieve 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 from03 to 03.05 to 03.05.01).
Path Parameters
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 includesrequest_id.
string
The requested Vienna code, normalized to the zero-padded dotted form.
string
Always
design_code.string
Two-digit category code (e.g.
03).string | null
Division-level code (e.g.
03.05). null for depth-1 codes.string | null
Section-level code (e.g.
03.05.01). null for depth-1 and depth-2 codes.integer
Depth (1, 2, or 3).
string
Description text.
string | null
Additional Vienna notes when published by WIPO.
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
| Status | Type | Description |
|---|---|---|
| 401 | unauthorized | Missing or invalid API key |
| 403 | forbidden | API key lacks trademarks:read scope |
| 404 | not_found | Vienna code does not exist |
Related Endpoints
- List Design Codes
- Search Trademarks, filter by
vienna_codes