List Design Codes
Classifications
List Design Codes
List Vienna figurative classification codes
GET
List Design Codes
Overview
Lists Vienna classification design codes used to describe figurative elements in trademarks. Filter by depth (1 = category, 2 = division, 3 = section) or search descriptions. Use this to build Vienna code pickers.Query Parameters
Substring search across descriptions (case-insensitive, max 200 chars).
Filter by depth:
1 (category), 2 (division), or 3 (section).Two-digit category code filter (e.g.
03).Max results (1-500).
Pagination cursor (the code of the last item returned).
Response
This endpoint is publicly cacheable, so the response never includesrequest_id.
Always
list.Array of Vienna code records ordered by code.
Vienna code (e.g.
03, 03.05, 03.05.01).Always
design_code.Two-digit category code (e.g.
03).Division-level code (e.g.
03.05). null for depth-1 codes.Section-level code (e.g.
03.05.01). null for depth-1 and depth-2 codes.Depth (1, 2, or 3).
Description text.
Whether more pages are available.
Code Examples
Errors
| Status | Type | Description |
|---|---|---|
| 400 | validation_error | Invalid depth or query length |
| 401 | unauthorized | Missing or invalid API key |
| 403 | forbidden | API key lacks trademarks:read scope |
Related Endpoints
- Get Design Code, single code with children
- List Trademarks, search by
vienna_codes