API reference · Platform & integration

Ticketing waiting room

GET/ticketing/occurrence/{reference}/waiting-roomThe waiting room of an occurrence
PUT/ticketing/occurrence/{reference}/waiting-roomConfigure the waiting room of a high-demand occurrence (OWNER or MANAGER)
GET/ticketing/public/{tenantId}/queue/{occurrence}/fairnessWaiting-room fairness record
DELETE/ticketing/queue/entry/{reference}Leave the waiting room
GET/ticketing/queue/entry/{reference}Your waiting-room entry
POST/ticketing/queue/{occurrence}/joinJoin the waiting room

GET The waiting room of an occurrence

GET /ticketing/occurrence/{reference}/waiting-room

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`reference`

Example

Response: GenericResponseWaitingRoomResponse

curl -X GET "https://api.bridgemoni.com/ticketing/occurrence/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/waiting-room" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "opensAt": "2026-09-25T10:00:00Z",
    "salesStartAt": "2026-09-25T10:00:00Z",
    "status": "SCHEDULED",
    "seedCommitment": "string",
    "revealedSeed": "string",
    "shuffledAt": "2026-09-25T10:00:00Z",
    "admitPerInterval": 0,
    "admissionTtlSeconds": 0,
    "perBuyerCap": 0
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

PUT Configure the waiting room of a high-demand occurrence (OWNER or MANAGER)

PUT /ticketing/occurrence/{reference}/waiting-room

Times are venue-local. The shuffle seed is generated here and only its SHA-256 is shown until the sale starts.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Content-Type`	application/json

Path parameters

Name
`reference`

Example

Request body: WaitingRoomRequest · Response: GenericResponseWaitingRoomResponse

curl -X PUT "https://api.bridgemoni.com/ticketing/occurrence/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/waiting-room" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "opensAt": "2026-09-25T10:00:00Z",
  "admitPerInterval": 0,
  "admissionTtlSeconds": 0,
  "perBuyerCap": 0
}'

{
  "opensAt": "2026-09-25T10:00:00Z",
  "admitPerInterval": 0,
  "admissionTtlSeconds": 0,
  "perBuyerCap": 0
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "opensAt": "2026-09-25T10:00:00Z",
    "salesStartAt": "2026-09-25T10:00:00Z",
    "status": "SCHEDULED",
    "seedCommitment": "string",
    "revealedSeed": "string",
    "shuffledAt": "2026-09-25T10:00:00Z",
    "admitPerInterval": 0,
    "admissionTtlSeconds": 0,
    "perBuyerCap": 0
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Waiting-room fairness record

GET /ticketing/public/{tenantId}/queue/{occurrence}/fairness

The seed commitment, and once the sale starts the revealed seed and every pre-sale entry's position. Position = rank of HMAC-SHA256(seed, entryReference).

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`X-Forwarded-For`

Path parameters

Name
`tenantId`
`occurrence`

Example

Response: GenericResponseFairnessResponse

curl -X GET "https://api.bridgemoni.com/ticketing/public/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/queue/value/fairness" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "seedCommitment": "string",
    "revealedSeed": "string",
    "shuffledAt": "2026-09-25T10:00:00Z",
    "preSaleEntries": [
      {
        "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "position": 0
      }
    ]
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

DELETE Leave the waiting room

DELETE /ticketing/queue/entry/{reference}

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`reference`

Example

Response: GenericResponseQueueEntryResponse

curl -X DELETE "https://api.bridgemoni.com/ticketing/queue/entry/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "status": "WAITING",
    "preSale": true,
    "position": 0,
    "ahead": 0,
    "admissionToken": "string",
    "admissionExpiresAt": "2026-09-25T10:00:00Z"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Your waiting-room entry

GET /ticketing/queue/entry/{reference}

Poll every 10 seconds. Once ADMITTED the response carries a fresh single-use admission token for POST ticketing/hold.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`reference`

Example

Response: GenericResponseQueueEntryResponse

curl -X GET "https://api.bridgemoni.com/ticketing/queue/entry/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "status": "WAITING",
    "preSale": true,
    "position": 0,
    "ahead": 0,
    "admissionToken": "string",
    "admissionExpiresAt": "2026-09-25T10:00:00Z"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Join the waiting room

POST /ticketing/queue/{occurrence}/join

Before the sale starts every entry is shuffled at the start by a committed seed; after it, entries join at the back.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`X-Device-Reference`

Path parameters

Name
`occurrence`

Example

Response: GenericResponseQueueEntryResponse

curl -X POST "https://api.bridgemoni.com/ticketing/queue/value/join" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "status": "WAITING",
    "preSale": true,
    "position": 0,
    "ahead": 0,
    "admissionToken": "string",
    "admissionExpiresAt": "2026-09-25T10:00:00Z"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

Generated from the OpenAPI document. Branch on the HTTP status: there is no machine-readable error code on the wire. Errors