GET /v1/partner/tickets/{ref}

Devuelve el estado actual de un boleto de tu proveedor.

Método y ruta	GET /v1/partner/tickets/{ref}?experienceId=<uuid>
Auth	Authorization: Bearer agk_…
Rate limit	60 req/min por llave (todos los ref comparten el contador)

Parámetros

Parámetro	En	Tipo	Obligatorio	Límite	Descripción
ref	path	string	Sí	1 – 200 chars	externalRef del boleto. URL-encodéalo si trae /, ?, #, espacios…
experienceId	query	string (UUID)	Sí		Experiencia enlazada a tu proveedor.

Respuesta 200

{
  "externalRef": "TG-1001",
  "experienceId": "22222222-2222-4222-8222-222222222222",
  "status": "redeemed",
  "redeemedAt": "2026-08-29T10:00:01.123456+00:00",
  "syncedAt": "2026-08-28T09:00:00.000+00:00"
}

Campo	Tipo	Descripción
externalRef	string	Tu ID del boleto.
experienceId	string (UUID)
status	"valid" | "redeemed" | "void"	Estado actual. Un boleto multi-uso sigue valid hasta agotar sus usos.
redeemedAt	string (ISO 8601) | null	Cuándo se redimió (o agotó). null si no está redimido.
syncedAt	string (ISO 8601) | null	Última vez que un bulk, feed o void tocó el boleto.

Las fechas son ISO 8601 con zona horaria; la precisión de los decimales puede variar. Parsea, no compares strings.

Nota

Este endpoint no expone el contador de usos de un boleto multi-uso. Cada uso llega por webhook con uses y max_uses.

Errores

HTTP	code	Cuándo
400	VALIDATION_FAILED	experienceId ausente o no es UUID; ref vacío o > 200 chars.
401	KEY_INVALID	Llave inválida.
403	EXPERIENCE_NOT_LINKED	La experiencia no está enlazada a tu proveedor.
404	TICKET_NOT_FOUND	No existe ese externalRef en esa experiencia (para tu proveedor).
429	RATE_LIMITED	Más de 60 requests por minuto.
500	INTERNAL	Error nuestro; reintenta con backoff.

Ejemplo

curl -s "https://gate-partners.alpadevs.com/v1/partner/tickets/TG-1001?experienceId=22222222-2222-4222-8222-222222222222" \
  -H "Authorization: Bearer $GATE_KEY"

{
  "externalRef": "TG-1001",
  "experienceId": "22222222-2222-4222-8222-222222222222",
  "status": "valid",
  "redeemedAt": null,
  "syncedAt": "2026-08-28T09:00:00.000+00:00"
}

Con un externalRef que contiene caracteres especiales (ORD/2026#77):

curl -s "https://gate-partners.alpadevs.com/v1/partner/tickets/ORD%2F2026%2377?experienceId=22222222-2222-4222-8222-222222222222" \
  -H "Authorization: Bearer $GATE_KEY"