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

# Merch

> List and retrieve catalog items with the Fanhaven API.

Merch is the product catalog for the tour bound to the API key. Prices are integers in the smallest currency unit (cents). Deleted items are omitted.

Required scope: `merch:read`.

## List merch

```
GET /v1/merch
```

| Query      | Description                         |
| ---------- | ----------------------------------- |
| `page`     | Page number. Default `1`.           |
| `per_page` | Page size. Default `25`, max `100`. |
| `search`   | Match item name                     |
| `status`   | `live` or `hidden`                  |

```bash theme={null}
curl "https://api.fanhaven.com/v1/merch?status=live" \
  -H "Authorization: Bearer fh_live_..."
```

## Retrieve merch

```
GET /v1/merch/:id
```

```bash theme={null}
curl "https://api.fanhaven.com/v1/merch/merch_..." \
  -H "Authorization: Bearer fh_live_..."
```

## Merch object

```json theme={null}
{
  "id": "merch_...",
  "name": "Tour Tee",
  "description": null,
  "status": "live",
  "kind": "merch",
  "category": "apparel",
  "type": "t-shirt",
  "color": "Black",
  "available_online": true,
  "prices": [{ "currency": "USD", "amount": 4500 }],
  "photos": [{ "url": "https://...", "view": "front" }],
  "variants": [{ "size": "M", "sku": "TEE-M" }],
  "created_at": "2026-08-01T12:00:00.000Z"
}
```