Saltar al contenido principal
tickts · developers

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.

tu primera petición
# 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" }
OpenAPI 3.0.3 Claves de API con alcance limitado Webhooks firmados con HMAC Servidor MCP 32 endpoints Sin comisiones de API
Inicio rápido

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.

1

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.

2

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.

3

Build

Lista eventos, emite entradas, descarga asistentes, suscríbete a webhooks. Documentación interactiva completa en la Referencia de la API.

Lo que puedes construir

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 /events

Pedidos y reembolsos

Lista y examina pedidos, emite reembolsos totales o parciales, reenvía o cancela entradas concretas.

GET /orders · POST /orders/{id}/refund

Asistentes 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/scan

Invitaciones y listas de invitados

Emite invitaciones de forma programada, perfecto para listas de invitados e integraciones.

POST /events/{id}/tickets

Abonos de temporada

Consulta los abonos de temporada y las membresías de varios días asociadas a un evento.

GET /events/{id}/season-passes

Pagos 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/summary

Espacios y asientos

Gestiona espacios, planos de asientos, disponibilidad en directo y bloqueos de butacas para eventos con asiento numerado.

GET /venues · POST /seating/hold

Promociones y descuentos

Crea y gestiona códigos de descuento y promociones desde tus propias herramientas.

GET · POST /promos

Calendario en bloque

Crea toda una temporada de partidos en una sola llamada, pensado para clubes.

POST /fixtures/bulk

Feed 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 /events
Feed público de eventos

Redifunde 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.
Clave de socio opcional

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].

Ejemplo

Descargar la siguiente página de eventos de música

request
curl "https://tickts.co.uk/api/v1/feed/events?genre=music&per_page=200"
respuesta (abreviada)
{
  "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" }
}
Autenticación

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 eventos
events:writeCrear y actualizar eventos
orders:readLeer pedidos
orders:writeReembolsar pedidos
scanValidar 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 recintos
venues:writeCrear recintos
fans:readLeer datos de seguidores y clientes
analytics:readLeer la analítica
promos:readLeer códigos promocionales
promos:writeCrear códigos promocionales
webhooks:readListar suscripciones de webhooks
webhooks:writeCrear y eliminar suscripciones de webhook
payouts:readLeer historial de pagos / liquidaciones y saldo
calendar:writeAñadir entradas de agenda a tu calendario
Webhooks

En 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.

order.created order.refunded ticket.checked_in event.published
suscribirse a un webhook
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"] }'
Ejemplos

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]" }),
});
Nativo para IA

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

Bien hecho

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.