API · v1 · read-only

PASE API

The PASE API lets another system read the data of an event: its totals, the registrations and the check-ins recorded at the door. It is read-only, it is meant for server to server use, and each key belongs to a single event.

Overview

Base URL

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

Getting a key

The event organizer creates the key from the PASE panel. There is no need to request it from anyone.

  1. Log in to the panel with a user that has manager permission on the event (the organizer or an administrator).
  2. Open the event and go to the "API" section.
  3. Give the key a name that will help you recognize it later (for example, the system that will use it) and create it.
  4. Copy it right then and store it somewhere safe.

If you do not see the "API" section in your event, or the panel says the API is not enabled yet, write to contacto@somosder.com.ar or message us on WhatsApp at +54 9 11 7154-0675.

Authentication

Every request carries the key in the Authorization header, with the Bearer scheme:

Authorization: Bearer <key>

A key is made of pase_, 8 hexadecimal characters, an underscore and 48 more hexadecimal characters. The first 13 characters (for example pase_1a2b3c4d) are the prefix the panel shows so you can recognize the key; the rest is the secret.

The examples on this page read the key from an environment variable. The sample key is not real:

export PASE_API_KEY="pase_1a2b3c4d_..."

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

Endpoints

There are three, all GET. Successful responses return 200 with an object that has a data key; lists add a pagination key.

PathWhat it returns
/api/v1/eventBasic data and totals of the event the key belongs to.
/api/v1/registrationsRegistrations of the event, paginated.
/api/v1/check-insCheck-ins accepted at the door, paginated.

GET /api/v1/event

Returns the basic data of the event and its totals. It takes no parameters.

Request

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

Response

{
  "data": {
    "id": "3f2b8c1e-5d4a-4f6b-9a7c-0e1d2c3b4a5f",
    "name": "Sample Conference 2027",
    "slug": "sample-conference-2027",
    "status": "open",
    "starts_at": "2027-03-18T12:00:00+00:00",
    "venue": "Sample Convention Center, 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": "Press",
          "registered": 62,
          "checked_in": 27
        }
      ]
    }
  }
}

Fields

FieldTypeDescription
iduuidEvent identifier.
namestringEvent name.
slugstringShort name used in the registration URL.
statusstringdraft, open or closed.
starts_atdate or nullStart date and time.
venuestring or nullEvent venue.
capacitynumber or nullCapacity set on the event, if any.
totals.registerednumberRegistrations of the event, in any status.
totals.checked_innumberPasses that have already checked in. Each pass is counted once.
totals.by_attendee_typearrayThe same two totals per attendee type, with the id and name of each type, sorted by name.

GET /api/v1/registrations

Returns the registrations of the event, sorted by registration date from oldest to newest.

Parameters (all optional)

ParameterDescription
limitPage size, from 1 to 200. Default: 50. A value above 200 is lowered to 200.
cursorThe next_cursor of the previous page, unchanged. See Pagination.
updated_sinceISO 8601 date, for example 2027-03-18T12:00:00Z. Returns registrations created, approved or rejected, or checked in since that date. It does not detect data edits yet, such as a name change.
typeName of the attendee type, case-insensitive (for example press), or its id.
checked_intrue returns only those who checked in; false, only those who did not.

Request

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

Response

{
  "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": "Sample Company Inc.",
      "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": "Press",
      "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"
  }
}

Fields

FieldTypeDescription
iduuidRegistration identifier.
first_namestringFirst name. If the event form does not ask for first and last name separately, it holds the full name.
last_namestring or nullLast name, if the form asks for it separately.
full_namestringFull name.
emailstringEmail used to register.
companystring or nullCompany, if the form asks for it.
attendee_typestring or nullName of the attendee type.
statusstringconfirmed, pending (waiting for approval) or rejected.
registered_atdateWhen the person registered.
updated_atdateLatest activity: the most recent of the registration, the approval or rejection, and the last check-in.
checked_inbooleanWhether the person has checked in.
checked_in_atdate or nullWhen the person first checked in.

GET /api/v1/check-ins

Returns the check-ins of the event: one row per scan accepted at a control point, sorted by time from oldest to newest. Rejected scans (a repeated QR code, or one without permission for that zone) are not included.

Parameters (all optional)

ParameterDescription
limitPage size, from 1 to 200. Default: 50. A value above 200 is lowered to 200.
cursorThe next_cursor of the previous page, unchanged. See Pagination.
sinceISO 8601 date. Returns check-ins from that date and time onward.
control_pointId of a control point (the control_point_id returned by this same endpoint). Returns only the check-ins of that point.

Request

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

Response

{
  "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": "Main entrance",
      "sector": "Main hall",
      "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": "Press",
      "control_point_id": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
      "control_point": "Main entrance",
      "sector": "Main hall",
      "companions": 1,
      "scanned_at": "2027-03-18T12:31:55.07+00:00"
    }
  ],
  "pagination": {
    "limit": 2,
    "has_more": false,
    "next_cursor": null
  }
}

Fields

FieldTypeDescription
iduuidCheck-in identifier.
registration_iduuid or nullRegistration the scanned pass belongs to. It is the id returned by /api/v1/registrations.
attendee_typestring or nullName of the attendee type.
control_point_iduuid or nullIdentifier of the control point where the pass was scanned.
control_pointstring or nullName of the control point.
sectorstring or nullName of the zone.
companionsnumberCompanions recorded on that scan. 0 if there were none.
scanned_atdateDate and time of the scan.

Pagination

Lists (/registrations and /check-ins) use cursor pagination. Every response includes a pagination object:

FieldTypeDescription
limitnumberThe page size that was applied.
has_morebooleantrue if there are more results.
next_cursorstring or nullThe cursor of the next page. It is null when there are no more results.

To get the next page, repeat the request with the same filters and add cursor with the value of next_cursor. Keep going until has_more is false.

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

Errors

All errors have the same shape. To decide what to do in your code use code, which is fixed; message is a text in Spanish meant for a person and may change. Error codes are in Spanish.

{
  "error": {
    "code": "llave_invalida",
    "message": "La llave no es válida."
  }
}
StatusCodeWhen it happens
400parametro_invalidoA parameter has a value that cannot be read: a limit that is not a number of 1 or more, a date that is not ISO 8601, an altered cursor, a checked_in that is neither true nor false, or a control_point that is not an id.
401sin_llaveThe Authorization: Bearer header is missing.
401llave_invalidaThe key does not have the expected format or does not exist.
401llave_revocadaThe key was revoked from the panel.
404no_encontradoThe path does not exist, or the request carries the id of an event other than the one the key belongs to.
405metodo_no_permitidoThe method is not GET. The response includes the header Allow: GET.
429demasiados_pedidosThe request limit was exceeded. The Retry-After header says how many seconds to wait.
500error_internoSomething failed on the PASE side. You can retry a moment later.
503api_no_habilitadaThe API is not enabled yet. Write to us to have it enabled.

Limits

Data it does not return

The API returns only the fields listed on this page. Even if the event asked for them at registration, it does not return:

What it does not do yet

Contact

For questions about the API, or if you do not see the "API" section in the panel of your event:

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