API · v1 · solo lectura

API de PASE

La API de PASE permite leer desde otro sistema los datos de un evento: sus totales, los inscriptos y los ingresos registrados en la puerta. Es de solo lectura, se usa de servidor a servidor y cada llave pertenece a un solo evento.

Qué es

Dirección base

https://pase.somosder.ar/api/v1

Cómo se pide la llave

La llave la crea el organizador del evento desde el panel de PASE. No hace falta pedírsela a nadie.

  1. Entrá al panel con un usuario que tenga permiso de manager sobre el evento (el organizador o un administrador).
  2. Abrí el evento y andá a la sección «API».
  3. Poné un nombre que te sirva para reconocer la llave después (por ejemplo, el sistema que la va a usar) y creala.
  4. Copiala en ese momento y guardala en un lugar seguro.

Si no ves la sección «API» en tu evento, o el panel dice que la API todavía no está habilitada, escribinos a contacto@somosder.com.ar o por WhatsApp al +54 9 11 7154-0675.

Autenticación

Cada pedido lleva la llave en el encabezado Authorization, con el esquema Bearer:

Authorization: Bearer <llave>

La llave tiene la forma pase_, 8 caracteres hexadecimales, un guion bajo y 48 caracteres hexadecimales más. Los primeros 13 caracteres (por ejemplo pase_1a2b3c4d) son el prefijo que el panel muestra para reconocerla; el resto es el secreto.

Los ejemplos de esta página leen la llave de una variable de entorno. La llave de ejemplo no es real:

export PASE_API_KEY="pase_1a2b3c4d_..."

curl "https://pase.somosder.ar/api/v1/event" \
  -H "Authorization: Bearer $PASE_API_KEY"

Endpoints

Son tres, todos con GET. Las respuestas correctas devuelven 200 con un objeto que tiene la clave data; las listas suman la clave pagination.

RutaQué devuelve
/api/v1/eventDatos básicos y totales del evento de la llave.
/api/v1/registrationsInscriptos del evento, paginados.
/api/v1/check-insIngresos aceptados en la puerta, paginados.

GET /api/v1/event

Devuelve los datos básicos del evento y sus totales. No recibe parámetros.

Pedido

curl "https://pase.somosder.ar/api/v1/event" \
  -H "Authorization: Bearer $PASE_API_KEY"

Respuesta

{
  "data": {
    "id": "3f2b8c1e-5d4a-4f6b-9a7c-0e1d2c3b4a5f",
    "name": "Congreso de Ejemplo 2027",
    "slug": "congreso-de-ejemplo-2027",
    "status": "open",
    "starts_at": "2027-03-18T12:00:00+00:00",
    "venue": "Centro de Convenciones Ejemplo, Buenos Aires",
    "capacity": 800,
    "totals": {
      "registered": 412,
      "checked_in": 187,
      "by_attendee_type": [
        {
          "id": "a1a1a1a1-0000-4000-8000-000000000001",
          "name": "General",
          "registered": 350,
          "checked_in": 160
        },
        {
          "id": "a1a1a1a1-0000-4000-8000-000000000002",
          "name": "Prensa",
          "registered": 62,
          "checked_in": 27
        }
      ]
    }
  }
}

Campos

CampoTipoDescripción
iduuidIdentificador del evento.
nametextoNombre del evento.
slugtextoNombre corto que usa la dirección del registro.
statustextodraft (borrador), open (abierto) o closed (cerrado).
starts_atfecha o nullFecha y hora de inicio.
venuetexto o nullLugar del evento.
capacitynúmero o nullCapacidad cargada en el evento, si tiene.
totals.registerednúmeroInscriptos del evento, en cualquier estado.
totals.checked_innúmeroPases que ya ingresaron. Cada pase se cuenta una sola vez.
totals.by_attendee_typelistaLos mismos dos totales por tipo de asistente, con el id y el name de cada tipo, ordenados por nombre.

GET /api/v1/registrations

Devuelve los inscriptos del evento, ordenados por fecha de inscripción de la más antigua a la más nueva.

Parámetros (todos opcionales)

ParámetroDescripción
limitCantidad por página, de 1 a 200. Por defecto, 50. Un valor mayor a 200 se baja a 200.
cursorEl next_cursor de la página anterior, tal cual. Ver Paginación.
updated_sinceFecha ISO 8601, por ejemplo 2027-03-18T12:00:00Z. Trae los inscriptos creados, aprobados o rechazados, o ingresados desde esa fecha. Todavía no detecta ediciones de datos, como un cambio de nombre.
typeNombre del tipo de asistente, sin distinguir mayúsculas de minúsculas (por ejemplo prensa), o su id.
checked_intrue trae solo a los que ingresaron; false, solo a los que no.

Pedido

curl "https://pase.somosder.ar/api/v1/registrations?limit=2&checked_in=true" \
  -H "Authorization: Bearer $PASE_API_KEY"

Respuesta

{
  "data": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "first_name": "Lucía",
      "last_name": "Ferreyra",
      "full_name": "Lucía Ferreyra",
      "email": "lucia.ferreyra@example.com",
      "company": "Empresa Ejemplo S.A.",
      "attendee_type": "General",
      "status": "confirmed",
      "registered_at": "2027-03-02T13:15:27.48211+00:00",
      "updated_at": "2027-03-18T12:04:09.512+00:00",
      "checked_in": true,
      "checked_in_at": "2027-03-18T12:04:09.512+00:00"
    },
    {
      "id": "22222222-2222-4222-8222-222222222222",
      "first_name": "Martín",
      "last_name": "Sosa",
      "full_name": "Martín Sosa",
      "email": "martin.sosa@example.com",
      "company": null,
      "attendee_type": "Prensa",
      "status": "confirmed",
      "registered_at": "2027-03-10T14:25:41.120394+00:00",
      "updated_at": "2027-03-18T12:31:55.07+00:00",
      "checked_in": true,
      "checked_in_at": "2027-03-18T12:31:55.07+00:00"
    }
  ],
  "pagination": {
    "limit": 2,
    "has_more": true,
    "next_cursor": "MjAyNy0wMy0xMFQxNDoyNTo0MS4xMjAzOTQrMDA6MDB8MjIyMjIyMjItMjIyMi00MjIyLTgyMjItMjIyMjIyMjIyMjIy"
  }
}

Campos

CampoTipoDescripción
iduuidIdentificador del inscripto.
first_nametextoNombre. Si el formulario del evento no pide nombre y apellido por separado, trae el nombre completo.
last_nametexto o nullApellido, si el formulario lo pide por separado.
full_nametextoNombre completo.
emailtextoMail con el que se inscribió.
companytexto o nullEmpresa, si el formulario la pide.
attendee_typetexto o nullNombre del tipo de asistente.
statustextoconfirmed (confirmado), pending (espera aprobación) o rejected (rechazado).
registered_atfechaCuándo se inscribió.
updated_atfechaÚltimo movimiento: la más reciente entre la inscripción, la aprobación o el rechazo y el último ingreso.
checked_inbooleanoSi ya ingresó.
checked_in_atfecha o nullCuándo ingresó por primera vez.

GET /api/v1/check-ins

Devuelve los ingresos del evento: una fila por cada lectura aceptada en un punto de control, ordenadas por hora de la más antigua a la más nueva. Las lecturas rechazadas (un QR repetido o sin permiso para ese sector) no aparecen.

Parámetros (todos opcionales)

ParámetroDescripción
limitCantidad por página, de 1 a 200. Por defecto, 50. Un valor mayor a 200 se baja a 200.
cursorEl next_cursor de la página anterior, tal cual. Ver Paginación.
sinceFecha ISO 8601. Trae los ingresos desde esa fecha y hora.
control_pointId de un punto de control (el control_point_id que devuelve este mismo endpoint). Trae solo los ingresos de ese punto.

Pedido

curl "https://pase.somosder.ar/api/v1/check-ins?since=2027-03-18T12:00:00Z&limit=2" \
  -H "Authorization: Bearer $PASE_API_KEY"

Respuesta

{
  "data": [
    {
      "id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
      "registration_id": "11111111-1111-4111-8111-111111111111",
      "attendee_type": "General",
      "control_point_id": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
      "control_point": "Acceso principal",
      "sector": "Salón principal",
      "companions": 0,
      "scanned_at": "2027-03-18T12:04:09.512+00:00"
    },
    {
      "id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
      "registration_id": "22222222-2222-4222-8222-222222222222",
      "attendee_type": "Prensa",
      "control_point_id": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
      "control_point": "Acceso principal",
      "sector": "Salón principal",
      "companions": 1,
      "scanned_at": "2027-03-18T12:31:55.07+00:00"
    }
  ],
  "pagination": {
    "limit": 2,
    "has_more": false,
    "next_cursor": null
  }
}

Campos

CampoTipoDescripción
iduuidIdentificador del ingreso.
registration_iduuid o nullInscripto al que pertenece el pase leído. Es el id que devuelve /api/v1/registrations.
attendee_typetexto o nullNombre del tipo de asistente.
control_point_iduuid o nullIdentificador del punto de control donde se leyó.
control_pointtexto o nullNombre del punto de control.
sectortexto o nullNombre del sector.
companionsnúmeroAcompañantes anotados en esa lectura. Si no hubo, 0.
scanned_atfechaFecha y hora de la lectura.

Paginación

Las listas (/registrations y /check-ins) se paginan por cursor. Cada respuesta trae un objeto pagination:

CampoTipoDescripción
limitnúmeroEl tamaño de página que se aplicó.
has_morebooleanotrue si quedan más resultados.
next_cursortexto o nullEl cursor de la página siguiente. Es null cuando no hay más.

Para traer la página siguiente, repetí el pedido con los mismos filtros y sumá cursor con el valor de next_cursor. Seguí hasta que has_more sea false.

curl "https://pase.somosder.ar/api/v1/registrations?limit=2&checked_in=true&cursor=MjAyNy0wMy0xMFQxNDoyNTo0MS4xMjAzOTQrMDA6MDB8MjIyMjIyMjItMjIyMi00MjIyLTgyMjItMjIyMjIyMjIyMjIy" \
  -H "Authorization: Bearer $PASE_API_KEY"

Errores

Todos los errores tienen la misma forma. Para decidir qué hacer en tu código usá code, que es fijo; message es un texto en castellano para una persona y puede cambiar.

{
  "error": {
    "code": "llave_invalida",
    "message": "La llave no es válida."
  }
}
EstadoCódigoCuándo pasa
400parametro_invalidoUn parámetro tiene un valor que no se entiende: un limit que no es un número de 1 en adelante, una fecha que no es ISO 8601, un cursor alterado, un checked_in que no es true ni false, o un control_point que no es un id.
401sin_llaveFalta el encabezado Authorization: Bearer.
401llave_invalidaLa llave no tiene el formato esperado o no existe.
401llave_revocadaLa llave fue revocada desde el panel.
404no_encontradoLa ruta no existe, o el pedido trae el id de un evento que no es el de la llave.
405metodo_no_permitidoEl método no es GET. La respuesta trae el encabezado Allow: GET.
429demasiados_pedidosSe pasó el límite de pedidos. El encabezado Retry-After dice cuántos segundos esperar.
500error_internoFalló algo del lado de PASE. Se puede reintentar un momento después.
503api_no_habilitadaLa API todavía no está habilitada. Escribinos para activarla.

Límites

Datos que no devuelve

La API entrega solo los campos que figuran en esta página. Aunque el evento los haya pedido en el registro, no devuelve:

Lo que todavía no hace

Contacto

Por dudas sobre la API, o si no ves la sección «API» en el panel de tu evento:

Mail: contacto@somosder.com.ar
WhatsApp: +54 9 11 7154-0675