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"
}

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"