Scanner grants and self check-in
Offline manifest authority, organiser grant management, and short-lived door codes.
The three legacy /api/scan operations are documented separately in
Check-in sync. Scanner tokens are revocable, event-scoped grants.
Scanner requests also require a valid session for the signed-in user who owns
the target grant membership; the token alone is insufficient and does not grant
access to the organiser console.
| Operation | Access | Purpose |
|---|---|---|
GET /api/scanner/manifest | Session + scanner grant | Download currently entrance-eligible participant codes for the signed-in grant member. |
GET /api/scanner/staff | Organiser | Staff, bound grants, and revocation state for an event. |
POST /api/scanner/grants | Organiser | Issue a signed scanner grant for a live eligible membership. |
DELETE /api/scanner/grants | Organiser | Revoke a grant immediately for online calls. |
POST /api/scanner/organiser-grant | Organiser session | Resolve scanner, staff, or studio entry for the actor. |
GET /api/scanner/door-code | Organiser | Legacy registration-routing code; never an admission credential. |
POST /api/scanner/self-check-in | Session | Resolve a legacy code to registration/ticket guidance. Never records attendance. |
A missing session returns 401; a malformed or revoked manifest token returns
403; a grant whose event or membership was removed returns 404. Revocation
cannot retract a manifest already stored on an offline device. Sync still
rechecks the live grant before accepting queued writes. Mutations require an
exact configured Origin.
Registration access (HTTP API 3.0.0)
The legacy POST /api/scanner/self-check-in route retains its method and token input,
but no longer writes attendance. Valid codes return kind: "registration",
eventName, eventSlug and hasTicket. The former checked-in and no-ticket
results are retired. expired and event-missing remain unchanged. This is an
intentional major contract change; consumers must direct visitors to registration
or their ticket. Only authorised crew scanning confirms attendance.
Partner Registration uses the stable public event registration link with
source=entrance. Registration does not grant VIP access or scanner authority.

