GET /v1/partner/redemptions

Devuelve las redenciones de tus boletos (todas tus experiencias), ordenadas por redeemedAt ascendente y posteriores a since. Es el complemento del webhook: aunque lo tengas, usa este pull para reconciliar.

Método y ruta	GET /v1/partner/redemptions?since=<iso>&limit=<n>
Auth	Authorization: Bearer agk_…
Rate limit	60 req/min por llave

Query

Parámetro	Tipo	Obligatorio	Límite	Descripción
since	string (ISO 8601)	No	debe incluir zona (Z o ±hh:mm)	Cursor exclusivo: solo redenciones con redeemedAt > since. Omitido = desde el inicio.
limit	integer	No	1 – 500, default 100	Tamaño de página.

since sin zona horaria (por ejemplo 2026-08-29T00:00:00) responde 400.

Respuesta 200

{
  "items": [
    {
      "externalRef": "TG-1001",
      "experienceId": "22222222-2222-4222-8222-222222222222",
      "redeemedAt": "2026-08-29T10:00:01.123456+00:00"
    }
  ],
  "nextSince": null
}

Campo	Tipo	Descripción
items[].externalRef	string | null	Tu ID del boleto. null si el boleto se cargó sin externalRef.
items[].experienceId	string (UUID)
items[].redeemedAt	string (ISO 8601)	Instante de la redención. Es el valor que usas como cursor.
nextSince	string (ISO 8601) | null	Cursor para la siguiente página; null si no hay más por ahora.

Paginación

nextSince solo viene cuando la página llegó llena (items.length == limit) y entonces es el redeemedAt del último item. Una página parcial significa que el stream está drenado.

1. Llama sin since (o con tu último cursor guardado).
2. Procesa items (idempotentemente: un boleto puede repetirse si su redeemedAt coincide exactamente con el cursor de otra página).
3. Si nextSince no es null, repite con ?since=<nextSince>.
4. Si es null, guarda el redeemedAt del último item procesado y vuelve a llamar en tu siguiente ciclo de polling (por ejemplo, cada 5 minutos durante el evento).

SINCE=""
while :; do
  RES=$(curl -s "https://gate-partners.alpadevs.com/v1/partner/redemptions?limit=500${SINCE:+&since=$SINCE}" \
        -H "Authorization: Bearer $GATE_KEY")
  echo "$RES" | jq -c '.items[]'
  NEXT=$(echo "$RES" | jq -r '.nextSince')
  [ "$NEXT" = "null" ] && break
  SINCE=$(printf '%s' "$NEXT" | jq -sRr @uri)
done

Qué cuenta como redención aquí

Este pull lista boletos en estado redeemed: un boleto de un solo uso aparece al entrar; un boleto multi-uso aparece solo cuando agota su último uso. Los usos intermedios se notifican únicamente por webhook (con uses y max_uses). Ver Multi-usos.

Errores

HTTP	code	Cuándo
400	VALIDATION_FAILED	since no es ISO 8601 con zona; limit fuera de 1..500.
401	KEY_INVALID	Llave inválida.
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/redemptions?since=2026-08-29T00:00:00Z&limit=100" \
  -H "Authorization: Bearer $GATE_KEY"

{
  "items": [
    {
      "externalRef": "TG-1001",
      "experienceId": "22222222-2222-4222-8222-222222222222",
      "redeemedAt": "2026-08-29T10:00:01.123456+00:00"
    }
  ],
  "nextSince": null
}