> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boxpressd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Resolve cigar text

> Resolve supplied cigar text to ranked Boxpressd catalog candidates.

Use resolution when you have imperfect text rather than a Boxpressd public ID.

<ParamField header="x-boxpressd-key" type="string" required>
  Your developer application key.
</ParamField>

<ParamField body="query" type="string">
  Combined search text from 2 through 200 characters. Either `query` or `name` is required.
</ParamField>

<ParamField body="name" type="string">
  Cigar name. Either `query` or `name` is required.
</ParamField>

<ParamField body="brand" type="string">
  Optional brand name used for ranking and filtering.
</ParamField>

<ParamField body="limit" type="integer" default="5">
  Number of candidates from 1 through 10.
</ParamField>

```bash theme={null}
curl "https://api.boxpressd.com/v1/cigars/resolve" \
  --request POST \
  --header "content-type: application/json" \
  --header "x-boxpressd-key: $BOXPRESSD_DEVELOPER_API_KEY" \
  --data '{"brand":"Drew Estate","name":"Liga Privada No. 9"}'
```

The response contains `match`, ordered `candidates`, and a `resolved` boolean. The API does not currently return a confidence score.