Suggest alternative marks
POST /api/v1/marks/alternatives
Names that keep the idea of a risky mark. Each one has passed the refusal screen and a USPTO search.
In the MCP server this is suggest_alternatives.
Example
curl -X POST https://api.joinopenfile.com/v1/marks/alternatives \
-H "content-type: application/json" \
-d '{
"mark": "Best Candles",
"description": "scented candles",
"classes": [
4
]
}'Body
| Name | Type | Required | Description |
|---|---|---|---|
mark | string | Yes | The mark that's likely to be refused. |
description | string | No | What's sold under it. |
classes | array of integer | No | Nice classes to search. |
reasons | array of string | No | Why it's likely to be refused. |
Errors
| Status | When |
|---|---|
400 | Invalid input. |
429 | Too many requests. |
502 | The USPTO or a website didn't answer. Nothing was checked. |
The body is the error shape.