Merch - Fanhaven

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`

curl "https://api.fanhaven.com/v1/merch?status=live" \
  -H "Authorization: Bearer fh_live_..."

Retrieve merch

GET /v1/merch/:id

curl "https://api.fanhaven.com/v1/merch/merch_..." \
  -H "Authorization: Bearer fh_live_..."

Merch object

{
  "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"
}