Skip to main content
POST
/
v1
/
events
/
{eventId}
/
attendees
/
attendance
/
checkout
Record an event check-out
curl --request POST \
  --url https://api.zuddl.com/v1/events/{eventId}/attendees/attendance/checkout \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "qrCode": "EAFPSNAB2I",
  "occurredAt": "2026-06-12T14:33:00Z"
}
'
{
  "registrationId": "4fcebf73-3ddb-4fe6-b56d-5dd7dedb7c3d",
  "accountId": "9e2b6d4a-6c3a-4a7e-8d24-1c2f8a31a812",
  "speakerId": "d812a64f-8865-4289-9024-9a120792c3d8",
  "role": "ATTENDEE",
  "action": "CHECK_IN",
  "recordedAt": "2026-06-12T14:33:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.zuddl.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Provide your API key secret in the Authorization header

Path Parameters

eventId
string
required

Unique identifier of the event

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

Body

application/json
qrCode
string
required

QR code identifying the attendee. Accepts either the raw code (e.g. "EAFPSNAB2I") or a Zuddl deep-link URL such as "https://applink.zuddl.com/link/com.zuddl.portal/{eventId}/profile/{qrCode}" — the server extracts the trailing path segment when a URL is supplied.

Minimum string length: 1
Example:

"EAFPSNAB2I"

occurredAt
string<date-time>

ISO-8601 timestamp of the scan from the partner's device. Defaults to the server time when omitted.

Example:

"2026-06-12T14:33:00Z"

Response

Check-out recorded

registrationId
string<uuid>

Resolved registration id for the attendee. Null when the scanned user is a speaker without a registration record.

Example:

"4fcebf73-3ddb-4fe6-b56d-5dd7dedb7c3d"

accountId
string<uuid>

Resolved Zuddl account id for the user.

Example:

"9e2b6d4a-6c3a-4a7e-8d24-1c2f8a31a812"

speakerId
string<uuid>

Speaker id when the scanned user is a speaker for this event. Null otherwise.

Example:

"d812a64f-8865-4289-9024-9a120792c3d8"

role
enum<string>

Resolved role of the scanned user within the event.

Available options:
ATTENDEE,
ORGANIZER,
SPEAKER,
SPONSOR,
MODERATOR
Example:

"ATTENDEE"

action
enum<string>

Action recorded for this scan.

Available options:
CHECK_IN,
CHECK_OUT
Example:

"CHECK_IN"

recordedAt
string<date-time>

Timestamp recorded for the scan (echoes the request occurredAt or the server time used when omitted).

Example:

"2026-06-12T14:33:00Z"