Tickets API

The Tickets API allows you to validate, redeem (check in), and manage experience tickets. Each experience booking automatically generates QR code tickets that can be scanned at check-in using a barcode scanner or mobile device.

How Tickets Work

When an experience booking is created, tickets are automatically generated:

• One ticket per participant in the booking
• Each ticket has a unique code (e.g., EQTK-A3F8X9B2)
• Each ticket contains a QR code that encodes a URL: https://app.equipdash.com/t/EQTK-A3F8X9B2
• Scanning the QR code (or entering the code manually) validates and redeems the ticket

Ticket Lifecycle

Booking Created → Tickets Generated (status: active)
                        │
                        ▼
              Ticket Scanned / Redeemed (status: redeemed)
                        │
                        ▼
              Participant Checked In

Cancellation: When a booking is cancelled, all its tickets are automatically cancelled.

Ticket Statuses

Status	Description
active	Valid and ready for check-in
redeemed	Already checked in
cancelled	Booking was cancelled
expired	Past expiry date

API Endpoints

Method	Endpoint	Description	Scope Required
POST	/v1/tickets/validate	Validate a ticket without redeeming	tickets:read
POST	/v1/tickets/redeem	Validate and redeem (check in)	tickets:write
GET	/v1/tickets/{ticketCode}	Get ticket details	tickets:read
POST	/v1/tickets/{ticketCode}/unredeem	Undo a check-in	tickets:write
GET	/v1/bookings/{id}/tickets	Get all tickets for a booking	bookings:read

API Scopes

Scope	Description
tickets:read	View and validate experience tickets
tickets:write	Redeem and manage experience tickets

Ticket Code Format

Ticket codes follow the format EQTK-XXXXXXXX where X is an alphanumeric character. Codes are case-insensitive when validating.

When scanning a QR code, the scanner may capture the full URL (https://app.equipdash.com/t/EQTK-A3F8X9B2). The API automatically extracts the ticket code from URLs — you can pass either the code or the full URL to the validate/redeem endpoints.