Skip to main content
POST
Suggest Goods & Services

Overview

Draft a goods/services specification from a natural-language description. Returns ranked Nice classes with filing-ready wording per class, grounded in the pre-approved catalog (Harmonised Database + USPTO ID Manual). Every term in the response is an actual accepted term; invented wording never appears. Use this to power:
  • Filing wizards that auto-draft the goods/services block of an application
  • Attorney drafting tools
  • Multi-class application flows where each class is a separate line item
Just need the class numbers (no wording)? Use Suggest Classifications instead: same input, lighter response, billed at 1 unit.
Pass class_number in the body to restrict the response to a single, already-chosen class. This is useful when you’re refining wording inside a class the user has already picked. For background on Nice classes and office acceptance, see the Classifications and Goods/Services guide.

Body Parameters

description
string
required
Description of the goods, services, or business (3-500 characters). Natural-language, no special format.
jurisdiction_code
string
Optional ISO-3166-1 alpha-2 jurisdiction code (e.g. US, EU, GB). Biases retail-vs-product interpretation toward local practice.
class_number
integer
Optional Nice class (1-45). When set, scopes the response to that single class. Useful for refining wording when the class has already been chosen.

Response

object
string
Always goods_services_suggestion.
query
string
The description you submitted, echoed back.
classifier_version
string
Version tag of the classifier that produced this response.
classes
object[]
Ranked suggested classes, each with filing-ready accepted terms.
classes[].class_number
integer
Nice class number (1-45).
classes[].title
string
Canonical class title.
classes[].confidence
string
One of high, medium, or low.
classes[].rank
integer
1-indexed position in the returned ordering.
classes[].recommendation_type
string
One of core, conditional, or adjacent.
classes[].conditional_on
string | null
When recommendation_type is conditional, the condition under which this class applies. Otherwise null.
classes[].rationale
string
Short explanation of why this class was suggested.
classes[].accepted_terms
object[]
Paste-ready goods/services terms for this class, drawn only from the pre-approved catalog.
ambiguous
boolean
true when the description has two or more materially different filing strategies.
clarification_question
string | null
When ambiguous is true, a question to ask the user. Otherwise null.
request_id
string
Unique request identifier for support and debugging.
Each item in accepted_terms has this shape:

Billing

Billed as 2 credits (check endpoint type).

Code Examples

Full draft (let the classifier pick the classes)

Refine wording for a known class

Pass class_number when the applicant has already decided which class to file under and only needs the wording.
TypeScript

Errors