Turno0DevelopersObtener API key
API REST v1

Integra tus sistemas con Turno0

Administra filas, turnos, despacho, citas y catálogos desde tu propio software — todo lo que puedes hacer en el panel, ahora por API. Base URL: https://api.turno0.com/api/v1

1

Crea tu API key

En el panel de Turno0 ve a Configuración → Integraciones y crea una key eligiendo los módulos y el nivel de acceso (lectura/escritura). Requiere el plan Premium. La clave se muestra una sola vez.

2

Haz tu primera petición

Autentica cada petición con el header X-API-Key. Lista tus filas para obtener sus identificadores:

curl https://api.turno0.com/api/v1/queues \
  -H "X-API-Key: fxp_tu_clave"
3

Crea un turno

Usa el runId de la instancia abierta de tu fila. Con idempotencyKey los reintentos son seguros:

curl -X POST https://api.turno0.com/api/v1/queue-runs/{runId}/turns \
  -H "X-API-Key: fxp_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"peopleCount": 1, "idempotencyKey": "pedido-12345"}'

Qué puedes hacer

Filas

Crear y configurar filas, estaciones y horarios; abrir/cerrar la toma de turnos.

Turnos

Crear turnos, consultar posición y estimaciones, cancelar, tablero de llegadas.

Despacho

Llamar al siguiente, asignar estación, iniciar/finalizar atención, reabrir.

Citas

Generar horarios (slots), agendar, check-in y ciclo completo de la cita.

Códigos de acceso

Códigos VIP/invitación individuales o en lote.

Filas conectadas

Encadenar procesos: al terminar en una fila, el turno sigue en otra.

Sucursales

Catálogo de sucursales de la cuenta.

Analítica

Panel del día y métricas históricas (solo lectura).

Webhooks

Suscripción a eventos firmados en tiempo real.