Construye tu venta de entradas
en cualquier cosa.
Una API REST completa, webhooks firmados en tiempo real, claves con alcance limitado y un servidor MCP. Todo lo que hace el panel de tickts lo puede hacer tu código, con cero comisiones de API por entrada.
# Introspect your key: who am I, which scopes, what rate limit? curl https://tickts.co.uk/api/v1/me \ -H "X-Api-Key: sk_live_your_key" # → { "organiser": "Bar Sport Cannock", # "scopes": ["events:read","orders:read"], # "rate_limit": "600/min" }
En marcha en tres pasos
Sin llamada comercial ni lista de espera. Genera una clave desde tu panel y haz tu primera llamada en menos de un minuto.
Generar una clave
En tu panel ve a Desarrolladores y crea una clave. Elige exactamente los permisos que necesita: las claves llevan privilegio mínimo por defecto y fallan en cerrado.
Authenticate
Envíala como X-Api-Key o un Bearer en cada petición a /api/v1. Todo el tráfico va solo por HTTPS.
Build
Lista eventos, emite entradas, descarga asistentes, suscríbete a webhooks. Documentación interactiva completa en la Referencia de la API.
Toda la plataforma, programable
32 puntos de acceso para eventos, pedidos, asistentes, pagos y más: el mismo motor que mueve tickts.co.uk.
Eventos y tipos de entrada
Crea, modifica, publica y cancela eventos, y gestiona tipos de entrada, tramos, precios y aforo.
GET · POST · PUT /eventsPedidos y reembolsos
Lista y examina pedidos, emite reembolsos totales o parciales, reenvía o cancela entradas concretas.
GET /orders · POST /orders/{id}/refundAsistentes y control de acceso
Descarga la lista de asistentes en directo, valida y escanea entradas en la puerta desde tu propia aplicación.
GET /events/{id}/attendees · POST /tickets/scanInvitaciones y listas de invitados
Emite invitaciones de forma programada, perfecto para listas de invitados e integraciones.
POST /events/{id}/ticketsAbonos de temporada
Consulta los abonos de temporada y las membresías de varios días asociadas a un evento.
GET /events/{id}/season-passesPagos y analítica
Lista las liquidaciones de Stripe y tu saldo, y descarga la analítica de ventas, datos que la mayoría de plataformas nunca expone.
GET /payouts · GET /analytics/summaryEspacios y asientos
Gestiona espacios, planos de asientos, disponibilidad en directo y bloqueos de butacas para eventos con asiento numerado.
GET /venues · POST /seating/holdPromociones y descuentos
Crea y gestiona códigos de descuento y promociones desde tus propias herramientas.
GET · POST /promosCalendario en bloque
Crea toda una temporada de partidos en una sola llamada, pensado para clubes.
POST /fixtures/bulkFeed público de eventos
No hace falta clave. Todas las fechas próximas en tickts, paginadas, con espacio, coordenadas, géneros, artistas, precios y sincronización incremental, para webs de agenda y agregadores.
GET /feed/events · GET /eventsRedifunde la cartelera, sin clave
Las webs de agenda, los agregadores y las aplicaciones de ocio pueden descargar cada evento público de tickts directamente desde GET /api/v1/feed/events. Una fila por cada fecha próxima, empezando por la más cercana, envuelta en un { data, meta } sobre con meta.next para la página siguiente. Consulta con since= para recibir solo lo que ha cambiado, incluidas las cancelaciones como marcas status: "cancelled" de cancelación, para que tu copia nunca se quede desfasada.
Los eventos no listados y los borradores no aparecen nunca. Los eventos con ubicación privada solo muestran la zona. Los eventos en línea no llevan ubicación física. Todas las horas van en ISO 8601 de Europe/London; los precios están en la moneda del organizador (currency en cada fila: GBP o EUR). Limitado a 60 solicitudes por minuto; consulta con since= en lugar de volver a descargarlo todo.
page, per_pagePaginación. per_page de 1 a 500 (100 por defecto).sinceISO 8601 o Y-m-d. Solo las fechas cuyo evento o fecha haya cambiado a partir de ese instante, más las marcas de cancelación.include_cancelled1 para incluir las fechas canceladas como tombstones en una descarga completa.genreIdentificador o nombre del género, p. ej.: música, comedia, teatro, deporte (coincide con el género o con el que lo engloba).countryPaís del espacio en ISO 3166-1 alfa-2, p. ej.: GB, IE.from, toLímites de fecha en formato Y-m-d.organiserSolo los eventos de un organizador (su identificador de organizador en tickts).artist, qBúsqueda de texto libre en el título, el organizador y el nombre del artista.online1 = solo eventos online, 0 = solo eventos presenciales.El feed no necesita clave y nunca la necesitará. Si redifundes eventos de tickts de forma periódica, pídenos igualmente una clave de socio y envíala como X-TK-Feed-Key (or Authorization: Bearer). Aumenta tu límite por encima de las 60 peticiones anónimas por minuto, te identifica en nuestros registros para poder avisarte antes de cualquier cambio y registra automáticamente la dirección de tu importador en nuestra protección contra bots, para que una descarga nocturna programada desde un centro de datos nunca se encuentre con una página de verificación. Escribe a [email protected].
Descargar la siguiente página de eventos de música
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" }
}
Claves con alcance limitado y privilegio mínimo
Cada clave lleva una lista explícita de permisos y no concede nada más (una clave sin permisos no puede hacer nada: falla en cerrado). Envíala como X-Api-Key o un Authorization: Bearer header.
events:readLeer eventosevents:writeCrear y actualizar eventosorders:readLeer pedidosorders:writeReembolsar pedidosscanValidar y escanear entradas (las dos de abajo, se mantiene para integraciones antiguas)tickets:readValidar códigos de entrada (solo lectura)tickets:scanEscanear entradas (registra el acceso)venues:readLeer recintosvenues:writeCrear recintosfans:readLeer datos de seguidores y clientesanalytics:readLeer la analíticapromos:readLeer códigos promocionalespromos:writeCrear códigos promocionaleswebhooks:readListar suscripciones de webhookswebhooks:writeCrear y eliminar suscripciones de webhookpayouts:readLeer historial de pagos / liquidaciones y saldocalendar:writeAñadir entradas de agenda a tu calendarioEn tiempo real, firmados y con reintentos
Suscribe un punto de acceso a través de la API y tickts te envía los eventos en cuanto ocurren, sin consultas periódicas. Cada carga va firmada con X-Tickts-Signature (HMAC-SHA256) para que puedas comprobar que viene de nosotros; los envíos se ponen en cola y se reintentan.
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"] }'
Copia, pega y publica
Emite una invitación para una lista de invitados, con lo que sea que uses para programar.
curl -X POST https://tickts.co.uk/api/v1/events/759/tickets \ -H "X-Api-Key: sk_live_your_key" \ -H "Content-Type: application/json" \ -d '{ "ticket_type": "GA", "quantity": 2, "name": "Guest List", "email": "[email protected]" }'
$res = Http::withHeaders(['X-Api-Key' => 'sk_live_your_key']) ->post('https://tickts.co.uk/api/v1/events/759/tickets', [ 'ticket_type' => 'GA', 'quantity' => 2, 'email' => '[email protected]', ]);
import requests requests.post( "https://tickts.co.uk/api/v1/events/759/tickets", headers={"X-Api-Key": "sk_live_your_key"}, json={"ticket_type": "GA", "quantity": 2, "email": "[email protected]"}, )
await fetch("https://tickts.co.uk/api/v1/events/759/tickets", { method: "POST", headers: { "X-Api-Key": "sk_live_your_key", "Content-Type": "application/json" }, body: JSON.stringify({ ticket_type: "GA", quantity: 2, email: "[email protected]" }), });
Conecta un asistente de IA con MCP
tickts incluye un Model Context Protocol servidor, para que asistentes como Claude y Cursor puedan manejar tu taquilla directamente: consultar ventas, emitir invitaciones, responder a «¿cómo fue el viernes?», con tu propia clave de alcance limitado. Tu API está lista de serie para la web agéntica.
Endpoint: https://tickts.co.uk/api/mcp
Los detalles que importan
Versioned (/api/v1), HTTPS-only, rate-limited with clear headers, consistent JSON errors, cursor pagination, and a machine-readable Especificación OpenAPI 3.0.3 desde la que puedes generar un cliente. Pensada para desarrolladores (como nosotros).
Listo cuando tú lo estés.
Genera una clave con alcance limitado y haz tu primera llamada en el próximo minuto. Sin comisiones y sin filtros.