List Goods & Services
Goods & Services
List Goods & Services
Browse and search accepted goods & services terms across one Nice class or all 45
GET
List Goods & Services
Overview
Browse and search 96,000+ pre-approved goods & services descriptions from the Harmonised Database (HDB) and the USPTO ID Manual. Use this to power goods/services autocomplete in filing tools (passclass to scope results to a single Nice class), or to discover which classes accept a particular term (pass q without class for a cross-class search).
For background on how office acceptance works and the data sources behind this endpoint, see the Classifications & Goods/Services guide.
At least one of
q or class must be provided. For semantic class discovery from a natural-language business description (e.g. “SaaS tool for HR teams”), use Suggest Classifications. For a drafted goods/services specification with filing-ready wording per class, use Suggest Goods & Services.Query Parameters
Substring search across term text (2-200 characters). Optional if
class is set. Returns 400 validation_error if neither q nor class is provided.Nice class number (1-45). Optional if
q is set. Returns 400 if outside the 1-45 range, or 404 if the class number is in range but not loaded in reference data.Language code (e.g.
en, de, fr, es, it, ja).When
true, only return terms on the TMClass harmonised list.Max results (1-100).
Pagination cursor from
pagination.cursor of the previous page.Response
This endpoint is publicly cacheable, so the response never includesrequest_id.
Always
list.Array of term records ordered by term key.
The term text.
Stable normalized key for the term.
Nice class this term is filed under (1-45). Present on every result so cross-class searches render without follow-up fetches.
TMClass taxonomy path identifier, when available.
Whether the term is on the harmonised list.
Offices that accept this term (e.g.
USPTO, EUIPO).Source catalog (e.g.
tmclass, uspto_idm).Language code.
Whether more pages are available.
Code Examples
Scoped autocomplete (user already picked a class)
Cross-class discovery (which classes accept this term?)
Pass onlyq (omit class) and inspect class_number on each result to see which classes contain the wording.
Browse all terms in a class
Pass onlyclass (omit q) to page through the full list of accepted wording for one class.
TypeScript
Errors
Related Endpoints
- Suggest Goods & Services, drafts a filing-ready specification from a description
- Suggest Classifications, lighter tier, classes only
- Get Classification
- List Classifications