# Suggest alternative marks

Source: https://joinopenfile.com/docs/api/suggest-alternatives
Index: https://joinopenfile.com/llms.txt

`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

```bash
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](https://joinopenfile.com/docs/errors.md).