# Merchants

Merchants provide the canonical identity and display name for offer discovery.

## Endpoints

- `GET /api/v1/omni/merchant` returns merchants with at least one live offer for the issuer.
- `GET /api/v1/omni/merchant/{merchantId}` returns one issuer-scoped merchant by UUID, including a merchant needed for historical reconciliation.


```json
{
  "id": "0df83025-5c37-4bb2-a258-f06bc34fd495",
  "name": "Example Coffee"
}
```

Use `id`, not `name`, as the durable key. Names can be corrected and are not guaranteed to be unique outside the authenticated issuer's catalog.

An ID lookup returns `404` when the merchant is not available to the authenticated issuer, even if that UUID exists elsewhere in Percents. This prevents cross-issuer catalog discovery.