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
- Solo lectura. Todos los pedidos son
GET. La API no crea, no edita ni borra nada. - Versión 1. La versión va en la ruta:
/api/v1. - De servidor a servidor. Está pensada para llamarla desde tu servidor (un CRM, un tablero, un proceso de sincronización), no desde el navegador.
- Una llave por evento. Cada llave ve un solo evento. El evento sale siempre de la llave: ningún parámetro del pedido lo elige.
- JSON sobre HTTPS. Las respuestas son JSON en UTF-8. Las fechas salen en formato ISO 8601 con zona horaria.
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.
- Entrá al panel con un usuario que tenga permiso de manager sobre el evento (el organizador o un administrador).
- Abrí el evento y andá a la sección «API».
- Poné un nombre que te sirva para reconocer la llave después (por ejemplo, el sistema que la va a usar) y creala.
- Copiala en ese momento y guardala en un lugar seguro.
- Se muestra una sola vez. PASE guarda solo un hash de la llave, no la llave. Si la perdés no se puede recuperar: se revoca y se crea otra.
- Se puede revocar. Desde la misma sección, en cualquier momento. Una llave revocada deja de funcionar enseguida y los pedidos que la usan reciben
401con el códigollave_revocada. - Hasta 10 llaves activas por evento. Conviene usar una por sistema, para poder revocar una sin cortar las demás.
- Último uso. PASE anota cuándo se usó cada llave por última vez, con una precisión de un minuto.
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"
- No mandes la llave en la dirección ni como parámetro: solo se lee del encabezado.
- No la pongas en el código de una página web ni de una app: cualquiera que la vea puede leer los datos del evento.
- Si mandás
event_id,eventoeventocon el id de otro evento, la respuesta es404.
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.
| Ruta | Qué devuelve |
|---|---|
/api/v1/event | Datos básicos y totales del evento de la llave. |
/api/v1/registrations | Inscriptos del evento, paginados. |
/api/v1/check-ins | Ingresos 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
| Campo | Tipo | Descripción |
|---|---|---|
id | uuid | Identificador del evento. |
name | texto | Nombre del evento. |
slug | texto | Nombre corto que usa la dirección del registro. |
status | texto | draft (borrador), open (abierto) o closed (cerrado). |
starts_at | fecha o null | Fecha y hora de inicio. |
venue | texto o null | Lugar del evento. |
capacity | número o null | Capacidad cargada en el evento, si tiene. |
totals.registered | número | Inscriptos del evento, en cualquier estado. |
totals.checked_in | número | Pases que ya ingresaron. Cada pase se cuenta una sola vez. |
totals.by_attendee_type | lista | Los 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ámetro | Descripción |
|---|---|
limit | Cantidad por página, de 1 a 200. Por defecto, 50. Un valor mayor a 200 se baja a 200. |
cursor | El next_cursor de la página anterior, tal cual. Ver Paginación. |
updated_since | Fecha 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. |
type | Nombre del tipo de asistente, sin distinguir mayúsculas de minúsculas (por ejemplo prensa), o su id. |
checked_in | true 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
| Campo | Tipo | Descripción |
|---|---|---|
id | uuid | Identificador del inscripto. |
first_name | texto | Nombre. Si el formulario del evento no pide nombre y apellido por separado, trae el nombre completo. |
last_name | texto o null | Apellido, si el formulario lo pide por separado. |
full_name | texto | Nombre completo. |
email | texto | Mail con el que se inscribió. |
company | texto o null | Empresa, si el formulario la pide. |
attendee_type | texto o null | Nombre del tipo de asistente. |
status | texto | confirmed (confirmado), pending (espera aprobación) o rejected (rechazado). |
registered_at | fecha | Cuándo se inscribió. |
updated_at | fecha | Último movimiento: la más reciente entre la inscripción, la aprobación o el rechazo y el último ingreso. |
checked_in | booleano | Si ya ingresó. |
checked_in_at | fecha o null | Cuá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ámetro | Descripción |
|---|---|
limit | Cantidad por página, de 1 a 200. Por defecto, 50. Un valor mayor a 200 se baja a 200. |
cursor | El next_cursor de la página anterior, tal cual. Ver Paginación. |
since | Fecha ISO 8601. Trae los ingresos desde esa fecha y hora. |
control_point | Id 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
| Campo | Tipo | Descripción |
|---|---|---|
id | uuid | Identificador del ingreso. |
registration_id | uuid o null | Inscripto al que pertenece el pase leído. Es el id que devuelve /api/v1/registrations. |
attendee_type | texto o null | Nombre del tipo de asistente. |
control_point_id | uuid o null | Identificador del punto de control donde se leyó. |
control_point | texto o null | Nombre del punto de control. |
sector | texto o null | Nombre del sector. |
companions | número | Acompañantes anotados en esa lectura. Si no hubo, 0. |
scanned_at | fecha | Fecha y hora de la lectura. |
Paginación
Las listas (/registrations y /check-ins) se paginan por cursor. Cada respuesta trae un objeto pagination:
| Campo | Tipo | Descripción |
|---|---|---|
limit | número | El tamaño de página que se aplicó. |
has_more | booleano | true si quedan más resultados. |
next_cursor | texto o null | El 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"
- El cursor es opaco: no lo armes ni lo modifiques. Un cursor alterado devuelve
400. - El cursor solo marca la posición. Los filtros (
type,checked_in,updated_since,since,control_point) hay que mandarlos de nuevo en cada página. - El orden es siempre ascendente por fecha, así que lo que se inscribe o ingresa mientras recorrés las páginas aparece al final.
- Para una sincronización periódica, guardá la hora en que empezó la última pasada y mandala en
updated_since(inscriptos) o ensince(ingresos). - En las fechas, usá la terminación
Zo codificá el signo+como%2B: un+suelto en la dirección se lee como un espacio.
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."
}
}
| Estado | Código | Cuándo pasa |
|---|---|---|
400 | parametro_invalido | Un 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. |
401 | sin_llave | Falta el encabezado Authorization: Bearer. |
401 | llave_invalida | La llave no tiene el formato esperado o no existe. |
401 | llave_revocada | La llave fue revocada desde el panel. |
404 | no_encontrado | La ruta no existe, o el pedido trae el id de un evento que no es el de la llave. |
405 | metodo_no_permitido | El método no es GET. La respuesta trae el encabezado Allow: GET. |
429 | demasiados_pedidos | Se pasó el límite de pedidos. El encabezado Retry-After dice cuántos segundos esperar. |
500 | error_interno | Falló algo del lado de PASE. Se puede reintentar un momento después. |
503 | api_no_habilitada | La API todavía no está habilitada. Escribinos para activarla. |
Límites
- 120 pedidos por minuto por llave. El contador se lleva en memoria, por instancia del servidor: no es un contador global, así que el corte puede no ser exacto cuando los pedidos caen en instancias distintas. Las respuestas a pedidos con una llave válida traen el encabezado
X-RateLimit-Limit: 120. - 600 pedidos por minuto por dirección IP, contados antes de validar la llave.
- Al pasar un límite la respuesta es
429con el encabezadoRetry-After, en segundos. Esperá ese tiempo antes de volver a pedir. - Hasta 200 resultados por página.
- Sin CORS. La API no manda el encabezado
Access-Control-Allow-Origin, así que una página de otro sitio no puede leerla desde el navegador. Hay que llamarla desde un servidor. - Sin caché. Todas las respuestas salen con
Cache-Control: no-storey cada pedido lee los datos del momento.
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:
- Número de documento.
- Teléfono.
- Fotos ni selfies.
- Datos biométricos.
- Campos internos del equipo del evento.
Lo que todavía no hace
- Escritura. Crear o editar inscriptos y marcar ingresos por API: próximamente, sin fecha.
- Webhooks. Avisos automáticos a tu sistema cuando alguien se inscribe o ingresa: próximamente, sin fecha. Por ahora los cambios se consultan con
updated_sinceysince. - Tampoco hay llaves que abarquen varios eventos, SDK ni OAuth.
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