API-referens

Check-in

Doors, door scans and checking people in.

List doors

GET/events/{eventId}/doors

Lists the doors of an event where people are checked in: the main entrance, session doors and areas.

Behörigheter: events:read
Modul: checkin Avvisas med moduleOff medan evenemangets arrangör har modulen avstängd.

Parametrar

sökväg

eventIdstring (uuid)obligatorisk
The event's id.

Svar

200 The doors. DoorList
Fält
- dataDoor[]
  The doors.
  Visa fälten
  - doorIdstring (uuid)
    The door's id.
  - namestring
    What the steward sees.
  - kindstring
    Entrance, session or area.
    Något av: entrance, session, area
  - sessionIdstring (uuid)
    The session the door belongs to.
  - capacityinteger
    How many may be inside at once, when limited.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound.
409 moduleOff.
429 rateLimited.

Avvisningar

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound

Anrop

curl "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/doors" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/doors", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/doors");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/doors",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/doors" -Headers $headers

200 Exempelsvar

JSON

{
  "data": [
    {
      "doorId": "b3ac0010-0000-4000-8000-000000000000",
      "name": "Main entrance",
      "kind": "entrance",
      "sessionId": null,
      "capacity": null
    },
    {
      "doorId": "b3ac0010-0000-4000-8000-000000000001",
      "name": "Workshop Lab: threat modelling",
      "kind": "session",
      "sessionId": "b3ac0004-0000-4000-8000-00000000000c",
      "capacity": 30
    }
  ]
}

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/events/b3ac0000-0000-4000-8000-000000000001/doors",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

List door scans

GET/events/{eventId}/check-ins

Lists scans that let somebody in or out at any door of the event, oldest first after a given one, or the latest arrivals with sort=-created.

Behörigheter: checkins:read
Modul: checkin Avvisas med moduleOff medan evenemangets arrangör har modulen avstängd.

Parametrar

sökväg

eventIdstring (uuid)obligatorisk
The event's id.

frågesträng

cursorstring
Where the page starts: nextCursor from the page before, exactly as it was returned. Leave out for the first page.
afterinteger (int64)
The last check-in ID you have, or 0 for the start. Kept from before cursors.
Standard: 0
pageSizeinteger (int32)
How many on a page, up to 500. The same as limit.
Standard: 100
sortstring
The order of the list: changed for the oldest change first (the default, for a sync), or -created for the newest first.
Något av: changed, -created
Standard: "changed"
limitinteger (int32)
How many on a page, up to 500.
Standard: 100

Svar

200 Scans, and the cursor to pass next time. CheckInPage
Fält
- dataCheckIn[]
  The scans.
  Visa fälten
  - checkInIdinteger (int64)
    The scan's id, which only grows.
  - eventIdstring (uuid)
    The event's id.
  - attendeeIdstring (uuid)
    The attendee's id.
  - checkInListIdstring (uuid)
    The door's id.
  - listNamestring
    The door's name.
  - listKindstring
    Entrance, session or area.
    Något av: entrance, session, area
  - sessionIdstring (uuid)
    The session the door belongs to.
  - directionstring
    In or out.
    Något av: in, out
  - resultstring
    Welcome (first time), again, or out.
    Något av: welcome, again, out
  - scannedUtcstring (date-time)
    When, in UTC.
  - offlineboolean
    Whether the scanner was offline.
- afterinteger (int64)
  Pass this as after next time.
- hasMoreboolean
  Whether there are more after these.
- nextCursorstring eller null
  The cursor for the next page, or null on the last. Pass it as cursor; it pages without counting, unlike page.
400 invalidCursor, invalidSort.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound.
409 moduleOff.
429 rateLimited.

Avvisningar

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound invalidCursor invalidSort

Anrop

curl "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins?limit=2" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins?limit=2", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins?limit=2");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins", params={"limit": 2},
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins?limit=2" -Headers $headers

200 Exempelsvar

JSON

{
  "data": [],
  "after": 0,
  "hasMore": false,
  "nextCursor": null
}

400 invalidCursor, invalidSort.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidCursor",
  "title": "The cursor is not valid",
  "status": 400,
  "detail": "Pass nextCursor exactly as a list returned it, with the same filters.",
  "instance": "/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins",
  "code": "invalidCursor",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "Pass nextCursor exactly as a list returned it, with the same filters."
}

Get door counts

GET/events/{eventId}/check-ins/summary

Gets how the doors stand right now: checked in against registered, the last hour's arrivals and each door's counts.

Behörigheter: checkins:read
Modul: checkin Avvisas med moduleOff medan evenemangets arrangör har modulen avstängd.

Parametrar

sökväg

eventIdstring (uuid)obligatorisk
The event's id.

Svar

200 The counts. CheckInSummary
Fält
- eventIdstring (uuid)
  The event's id.
- registeredinteger (int32)
  Valid tickets, crew left out.
- checkedIninteger (int32)
  Of whom checked in at the main entrance.
- notYetinteger (int32)
  Registered and not checked in yet.
- ratenumber eller null
  Checked in as a percentage of registered.
- lastHourinteger (int32)
  Let in at an entrance in the last hour.
- doorsobject[]
  Each door.
  Visa fälten
  - doorIdstring (uuid)
    The door's id.
  - namestring
    Its name.
  - kindstring
    Entrance, session or area.
  - sessionIdstring (uuid) eller null
    The session the door belongs to.
  - capacityinteger (int32) eller null
    Its capacity.
  - admittedinteger (int32)
    People let in, each once.
  - insideinteger (int32)
    In and not out again.
  - lastHourinteger (int32)
    Let in in the last hour.
  - refusedinteger (int32)
    Scans refused.
- atUtcstring (date-time)
  When this was counted, in UTC.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound.
409 moduleOff, onlineEvent.
429 rateLimited.

Avvisningar

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound onlineEvent

Anrop

curl "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins/summary" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins/summary", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins/summary");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins/summary",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins/summary" -Headers $headers

200 Exempelsvar

JSON

{
  "eventId": "b3ac0000-0000-4000-8000-000000000001",
  "registered": 74,
  "checkedIn": 0,
  "notYet": 74,
  "rate": 0,
  "lastHour": 0,
  "doors": [
    {
      "doorId": "b3ac0010-0000-4000-8000-000000000000",
      "name": "Main entrance",
      "kind": "entrance",
      "sessionId": null,
      "capacity": null,
      "admitted": 0,
      "inside": 0,
      "lastHour": 0,
      "refused": 0
    },
    {
      "doorId": "b3ac0010-0000-4000-8000-000000000001",
      "name": "Workshop Lab: threat modelling",
      "kind": "session",
      "sessionId": "b3ac0004-0000-4000-8000-00000000000c",
      "capacity": 30,
      "admitted": 0,
      "inside": 0,
      "lastHour": 0,
      "refused": 0
    }
  ],
  "atUtc": "2026-10-14T21:47:33.737Z"
}

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/events/b3ac0000-0000-4000-8000-000000000001/check-ins/summary",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

Check in an attendee Ändrar data

POST/events/{eventId}/attendees/{attendeeId}/check-in

Checks an attendee in at the main entrance or at another door, by the same rules as a steward's scanner: a cancelled or unpaid ticket, a full room or a ticket type the door does not admit is refused, and result says so.

Behörigheter: checkins:write
Modul: checkin Avvisas med moduleOff medan evenemangets arrangör har modulen avstängd.

Skicka en Idempotency-Key så blir nya försök säkra. →

Parametrar

sökväg

eventIdstring (uuid)obligatorisk
The event's id.
attendeeIdstring (uuid)obligatorisk
The attendee's id.

huvud

Idempotency-Keystring
A key of your own, such as a UUID, so a retry after a lost connection is answered with the first answer instead of doing it twice. Kept 24 hours.

Brödtext CheckInRequest

The door, when it is not the main entrance.

doorIdstring (uuid)
The door, when it is not the main entrance.

Svar

200 What the door decided. CheckInResult
Fält
- resultstring
  Welcome (in for the first time), again, or why not: cancelled, unpaid, notOnList, noAddOn, full or noReentry.
- admittedboolean
  Whether the attendee was let in.
- firstCheckInUtcstring (date-time)
  When they were first checked in at the main entrance, in UTC.
- doorobject
  The door.
  Visa fälten
  - doorIdstring (uuid)
    The door's id.
  - namestring
    The door's name.
  - kindstring
    Entrance, session or area.
- attendeeAttendee
  Somebody holding a ticket, or who held one.
  Visa fälten
  - attendeeIdstring (uuid)
    The attendee's id.
  - eventIdstring (uuid)
    The event's id.
  - orderIdstring (uuid)
    The order's id.
  - orderReferencestring
    The order's six-character reference.
  - ticketTypeIdstring (uuid)
    The ticket type's id.
  - ticketTypeNamestring
    The ticket type's name.
  - firstNamestring eller null
    First name. Null without people:read, or when erased.
  - lastNamestring eller null
    Last name. Null without people:read, or when erased.
  - emailstring (email) eller null
    Email address. Null without people:read, or when erased.
  - companystring eller null
    Company. Null without people:read, or when erased.
  - jobTitlestring eller null
    Job title. Null without people:read, or when erased.
  - languagestring
    The language they registered in.
  - answersobject eller null
    Answers to the event's registration questions, by question id. Null without people:read, or when erased.
  - statusstring
    Active, or cancelled.
    Något av: active, cancelled
  - orderStatusstring
    The order's status.
    Något av: pending, paid, free, onAccount, transfer, requested, declined, cancelled, expired, refunded
  - validboolean
    Whether the ticket lets them in: not cancelled, and the order paid or free.
  - checkedInUtcstring (date-time) eller null
    When they were first checked in, in UTC.
  - createdUtcstring (date-time)
    When they registered, in UTC.
  - changedUtcstring (date-time) eller null
    When anything about the attendee or their order last changed. Pass the latest you have as updatedSince.
  - updatedUtcstring (date-time) eller null
    When anything about the attendee or their order last changed, in UTC: the same as changedUtc.
  - erasedboolean
    Whether the person deleted their data from the event app; then nothing personal is returned, whatever the key may read.
  - personalDatastring
    Whether the personal fields are here: included, withheld (the key lacks people:read) or erased (the person deleted their data).
    Något av: included, withheld, erased
400 invalidIdempotencyKey.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope, demoWorkspace.
404 eventNotFound, attendeeNotFound, noDoor.
409 moduleOff, onlineEvent, idempotencyKeyInUse.
422 idempotencyKeyReused.
429 rateLimited.

Avvisningar

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound attendeeNotFound noDoor onlineEvent demoWorkspace idempotencyKeyInUse idempotencyKeyReused invalidIdempotencyKey

Anrop

curl -X POST "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/attendees/b3ac0008-0000-4000-8000-000000000000/check-in" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "doorId": "b3ac0010-0000-4000-8000-000000000000"
}'

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/attendees/b3ac0008-0000-4000-8000-000000000000/check-in", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "doorId": "b3ac0010-0000-4000-8000-000000000000"
  })
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Post, "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/attendees/b3ac0008-0000-4000-8000-000000000000/check-in");
request.Headers.Add("Idempotency-Key", Guid.NewGuid().ToString());
request.Content = new StringContent("""
{
  "doorId": "b3ac0010-0000-4000-8000-000000000000"
}
""", Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os, uuid
import requests

response = requests.post(
    "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/attendees/b3ac0008-0000-4000-8000-000000000000/check-in",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}",
        "Idempotency-Key": str(uuid.uuid4())
    },
    json={
        "doorId": "b3ac0010-0000-4000-8000-000000000000"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
    "Idempotency-Key" = [guid]::NewGuid().ToString()
}
$body = @'
{
  "doorId": "b3ac0010-0000-4000-8000-000000000000"
}
'@

$data = Invoke-RestMethod -Method Post -Uri "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/attendees/b3ac0008-0000-4000-8000-000000000000/check-in" -Headers $headers -ContentType "application/json" -Body $body

400 invalidIdempotencyKey.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidIdempotencyKey",
  "title": "Idempotency-Key is not valid",
  "status": 400,
  "detail": "An Idempotency-Key is 1 to 255 visible ASCII characters; a UUID is a good one.",
  "instance": "/api/v1/events/b3ac0000-0000-4000-8000-000000000001/attendees/{attendeeId}/check-in",
  "code": "invalidIdempotencyKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "An Idempotency-Key is 1 to 255 visible ASCII characters; a UUID is a good one."
}

Guiderna och den här webbplatsen finns på ditt språk. API-referensens egna beskrivningar är på engelska, precis som API:t självt.

#List doors

Parametrar

Svar

Avvisningar

#List door scans

Parametrar

Svar

Avvisningar

#Get door counts

Parametrar

Svar

Avvisningar

#Check in an attendee Ändrar data

Parametrar

Brödtext CheckInRequest

Svar

Avvisningar

List doors

List door scans

Get door counts

Check in an attendee Ändrar data