API overview

The Fanhaven API is a REST interface for server-to-server integrations. Create a key in the dashboard, then call the endpoints documented here.

Get started

https://api.fanhaven.com/v1

Keys are bound to the tour they were created on. Fan endpoints are artist-wide. Transactions, events, and merch stay on that tour.

Successful responses:

{
  "success": true,
  "data": {}
}

List responses nest pagination inside data:

{
  "success": true,
  "data": {
    "items": [],
    "page": 1,
    "per_page": 25,
    "total": 0,
    "has_more": false
  }
}

Errors:

{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "A valid API key is required to access this route"
  }
}

120 requests per minute per key. Exceeding the limit returns 429 with code too_many_requests.

Resource	Use it for
Fans	Pull fan records into a CRM or warehouse
Transactions	Sales into your warehouse or finance tools
Events	Tour dates and venues
Merch	Catalog, prices, and variants
Webhooks	Push events instead of polling