Skip to main content

1. Get an API Key

Go to the Tickable dashboard and create an API key with the events.read scope.

2. List Your Events

curl https://api.tickable.io/events \
  -H "Authorization: Bearer tk_live_YOUR_API_KEY"
You should get a response like:
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Summer Festival 2026",
      "description": "Annual summer music festival",
      "location": "Vondelpark",
      "is_public": true,
      "created_at": "2026-04-01T12:00:00Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 25,
    "offset": 0,
    "has_more": false
  }
}

3. Get Event Details

Pick an event ID from the list and fetch its details including ticket types:
curl https://api.tickable.io/events/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer tk_live_YOUR_API_KEY"

4. List Tickets for an Event

Fetch tickets for an event. You’ll need an API key with the tickets.read scope:
curl https://api.tickable.io/events/550e8400-e29b-41d4-a716-446655440000/tickets \
  -H "Authorization: Bearer tk_live_YOUR_API_KEY"
Each ticket includes a status field (valid, scanned, or cancelled) so you can quickly see its state.

5. Set Up a Webhook (optional)

Get notified when orders come in. You’ll need an API key with the webhooks.write scope:
curl -X POST https://api.tickable.io/webhooks \
  -H "Authorization: Bearer tk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/webhook",
    "event_types": ["order.confirmed"]
  }'

Next Steps

Authentication

Learn about API keys, OAuth2, and scopes

Pagination

How to paginate through large result sets

Tickets Guide

List and scan tickets via the API

Webhooks Guide

Set up real-time notifications

API Reference

Explore all available endpoints