Redeem a ticket

POST

https://prod.your-api-server.com/tickets/redeem

Last modified:2026-04-29 08:09:11

Redeems a ticket token for the given event. First scan wins — re-scans
return AlreadyRedeemed. Set override=true to bypass the
doors-open grace check for VIPs / staff. Every attempt is recorded in
the audit log.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "bookableEventId": "8bf47dbd-19fc-4a7d-bf2f-e95dfd3ac955",
    "token": "string",
    "door": "string",
    "override": true,
    "notes": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://prod.your-api-server.com/tickets/redeem' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bookableEventId": "8bf47dbd-19fc-4a7d-bf2f-e95dfd3ac955",
    "token": "string",
    "door": "string",
    "override": true,
    "notes": "string"
}'

Responses

🟢200

application/json

Body

Example

{
    "outcome": "string",
    "ticketId": "e3e3e8ea-b02a-4536-85a2-a9c90f4ee74f",
    "holderName": "string",
    "ticketTypeName": "string",
    "previouslyRedeemedAt": "2019-08-24T14:15:22.123Z",
    "previouslyRedeemedByUserId": "81e7946a-e66f-4c95-bbea-7fb0ce0204f5",
    "previouslyRedeemedAtDoor": "string",
    "message": "string"
}

🟠400

🟠401

🟠409

🟠429

🔴500

Modified at 2026-04-29 08:09:11

Get the current tenant

List event types