Bouw ticketing
in alles.

Neem over wat er te doen is, geen sleutel nodig

Uitagenda's, aggregators en "wat is er te doen"-apps kunnen elk openbaar evenement op tickts rechtstreeks ophalen via GET /api/v1/feed/events. Eén rij per komende datum, eerstvolgende eerst, verpakt in een { data, meta } envelop met meta.next voor de volgende pagina. Poll met since= om alleen te ontvangen wat er is gewijzigd, inclusief annuleringen als status: "cancelled" markeringen, zodat jouw kopie nooit veroudert.

Verborgen evenementen en concepten verschijnen nooit. Evenementen op een besloten locatie tonen alleen het gebied. Online evenementen hebben geen fysieke locatie. Alle tijden zijn Europe/London ISO 8601; prijzen zijn in de valuta van de organisator (currency op elke rij: GBP of EUR). Beperkt tot 60 verzoeken per minuut; poll met since= in plaats van alles opnieuw op te halen.

Voor de feed is geen sleutel nodig, en dat blijft zo. Neem je tickts-evenementen volgens een schema over, vraag ons dan toch om een partnersleutel en stuur hem mee als X-TK-Feed-Key (or Authorization: Bearer). Daarmee gaat je limiet omhoog boven de anonieme 60 per minuut, sta je met naam in onze logboeken zodat we je kunnen waarschuwen voordat er iets verandert, en wordt het adres van je importer automatisch aangemeld bij onze botbescherming, zodat een geplande nachtelijke ophaalronde vanuit een datacenter nooit op een controlepagina stuit. Mail [email protected].

Haal de volgende pagina met muziekevenementen op

curl "https://tickts.co.uk/api/v1/feed/events?genre=music&per_page=200"

{
  "data": [{
    "id": "SE-kb759-20260912-2000",
    "event_id": 1041,
    "status": "scheduled",
    "title": "Hidden Jazz Club: Late Session",
    "description": "An intimate late-night set...",
    "url": "https://tickts.co.uk/events/hidden-jazz-club",
    "date_url": "https://tickts.co.uk/events/hidden-jazz-club?sub_event_id=SE-kb759-20260912-2000",
    "image": "https://tickts.co.uk/storage/events/card.jpg",
    "start_at": "2026-09-12T20:00:00+01:00",
    "doors_at": "2026-09-12T19:00:00+01:00",
    "timezone": "Europe/London",
    "venue": { "id": 812, "name": "The Bell Inn", "address": "12 High St", "city": "Bath",
               "postcode": "BA1 5AQ", "country": "GB", "lat": 51.38, "lng": -2.36 },
    "artists": [{ "name": "Ada Quartet", "headliner": true, "slug": "ada-quartet" }],
    "genres": [{ "name": "Jazz", "slug": "jazz", "parent": "Music" }],
    "category": "Music",
    "organiser": { "id": 812, "name": "Hidden Jazz Club" },
    "tickets": { "currency": "GBP", "sold_out": false, "cheapest": 12.5,
                 "types": [{ "name": "General Admission", "price": 12.5, "available": true }] },
    "sales_state": "on_sale",
    "updated_at": "2026-08-20T09:14:02+01:00"
  }],
  "meta": { "page": 1, "per_page": 200, "total": 1893, "total_pages": 10,
            "next": "https://tickts.co.uk/api/v1/feed/events?genre=music&per_page=200&page=2" }
}

Afgebakende sleutels, minimale rechten

Elke sleutel heeft een expliciete lijst met toegestane scopes en geeft niets daarbuiten (een sleutel zonder scopes kan niets, hij faalt gesloten). Stuur hem mee als X-Api-Key of een Authorization: Bearer header.

Realtime, ondertekend, opnieuw geprobeerd

Meld een endpoint aan via de API en tickts stuurt je gebeurtenissen zodra ze plaatsvinden, zonder polling. Elke payload is ondertekend met X-Tickts-Signature (HMAC-SHA256) zodat je kunt controleren dat het echt van ons komt; leveringen worden in een wachtrij gezet en opnieuw geprobeerd.

curl -X POST https://tickts.co.uk/api/v1/webhooks \
  -H "X-Api-Key: sk_live_your_key" \
  -d '{ "url": "https://you.com/hook",
       "events": ["order.created"] }'

Koppel een AI-assistent met MCP

tickts levert een Model Context Protocol server, zodat assistenten als Claude en Cursor je kassa rechtstreeks kunnen bedienen (verkoop bekijken, vrijkaarten uitgeven, "hoe ging vrijdag?" beantwoorden) met je eigen afgebakende sleutel. Je API is direct klaar voor het agentische web.

Endpoint: https://tickts.co.uk/api/mcp

Details die ertoe doen

Versioned (/api/v1), HTTPS-only, rate-limited with clear headers, consistent JSON errors, cursor pagination, and a machine-readable OpenAPI 3.0.3-specificatie waarmee je een client kunt genereren. Ontworpen met ontwikkelaars (zoals wij) in gedachten.