Transactions - Fanhaven

Transactions are completed and in-progress sales for the tour bound to the API key. Amounts are integers in the smallest currency unit (cents). Required scope: transactions:read.

List transactions

GET /v1/transactions

Query	Description
`page`	Page number. Default `1`.
`per_page`	Page size. Default `25`, max `100`.
`status`	`pending`, `paid`, `failed`, `refunded`, or `chargeback`
`event_id`	Filter to one tour date
`fan_id`	Filter to one fan
`created_after`	ISO timestamp lower bound
`created_before`	ISO timestamp upper bound

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

Retrieve a transaction

GET /v1/transactions/:id

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

Transaction object

{
  "id": "txn_...",
  "status": "paid",
  "payment_method": "card",
  "currency": "usd",
  "subtotal": 4500,
  "discount_amount": 0,
  "tax": 360,
  "tip": 500,
  "total": 5360,
  "fan_id": "fan_...",
  "event_id": "evt_...",
  "booth_id": null,
  "is_mobile_order": false,
  "fulfillment_method": "pickup",
  "pickup_status": null,
  "shipping_status": null,
  "items": [
    {
      "id": "ti_...",
      "name": "Tour Tee",
      "size": "M",
      "quantity": 1,
      "amount": 4500,
      "status": "paid"
    }
  ],
  "created_at": "2026-08-26T12:00:00.000Z"
}