Get Design Code

Retrieve a single Vienna classification code with notes and child codes

GET /v1/design-codes/{code}

Get Design Code

cURL

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

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
• List Trademarks, filter by vienna_codes