API reference · Platform & integration

Ticketing sales

Events, tickets and check-in. About events & ticketing Next

POST/ticketing/boxoffice/saleSell at the door (OWNER, MANAGER or BOX_OFFICE)
GET/ticketing/occurrence/{reference}/codePromo and access codes of an occurrence, with usage
POST/ticketing/occurrence/{reference}/codeCreate a promo or access code for an occurrence (OWNER or MANAGER)
POST/ticketing/occurrence/{reference}/compIssue complimentary tickets from a COMP tier to a Bridge user (OWNER or MANAGER)
GET/ticketing/ticket/{reference}/rotation-seedRelease a rotating ticket's seed to your linked device

POST Sell at the door (OWNER, MANAGER or BOX_OFFICE)

POST /ticketing/boxoffice/sale

CASH_ATTESTED: the organiser keeps the cash, tickets go to the buyer's phone as a pass, and the platform fee is netted at settlement. Cash sales cannot be refunded through the platform.

Headers

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

Example

Request body: BoxOfficeSaleRequest · Response: GenericResponseOrderResponse

curl -X POST "https://api.bridgemoni.com/ticketing/boxoffice/sale" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "lines": [
    {
      "tierReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "tierCode": "string",
      "quantity": 0,
      "seatReferences": [
        "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
      ]
    }
  ],
  "settlement": "WALLET_TRANSFER",
  "buyerPhone": "string",
  "attendeeName": "string"
}'

{
  "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "lines": [
    {
      "tierReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "tierCode": "string",
      "quantity": 0,
      "seatReferences": [
        "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
      ]
    }
  ],
  "settlement": "WALLET_TRANSFER",
  "buyerPhone": "string",
  "attendeeName": "string"
}

{
  "data": {
    "orderReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "holdReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "eventReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "status": "AWAITING_PAYMENT",
    "buyerKind": "USER",
    "paymentSource": "WALLET",
    "faceTotal": "string",
    "feeTotal": "string",
    "discountTotal": "string",
    "total": "string",
    "refundedTotal": "string",
    "currency": "string",
    "paymentCode": "string",
    "repeatOfOrderReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "tickets": [
      {
        "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "tierCode": "string",
        "generation": 0,
        "status": "ISSUED"
      }
    ],
    "creationDateTime": "2026-09-25T10:00:00Z",
    "paidAt": "2026-09-25T10:00:00Z"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Promo and access codes of an occurrence, with usage

GET /ticketing/occurrence/{reference}/code

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseListCodeResponse

curl -X GET "https://api.bridgemoni.com/ticketing/occurrence/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/code" \
  -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",
      "kind": "PROMO",
      "discountPercent": "string",
      "discountFixed": "string",
      "tierCodes": [
        "string"
      ],
      "usageCap": 0,
      "used": 0,
      "perBuyerCap": 0,
      "validFrom": "2026-09-25T10:00:00Z",
      "validTo": "2026-09-25T10:00:00Z"
    }
  ],
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Create a promo or access code for an occurrence (OWNER or MANAGER)

POST /ticketing/occurrence/{reference}/code

The code itself is never returned or stored; only its keyed fingerprint is kept.

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: CodeRequest · Response: GenericResponseCodeResponse

curl -X POST "https://api.bridgemoni.com/ticketing/occurrence/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/code" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "PROMO",
  "code": "string",
  "discountPercent": "string",
  "discountFixed": "string",
  "tierCodes": [
    "string"
  ],
  "usageCap": 0,
  "perBuyerCap": 0,
  "validFrom": "2026-09-25T10:00:00Z",
  "validTo": "2026-09-25T10:00:00Z"
}'

{
  "kind": "PROMO",
  "code": "string",
  "discountPercent": "string",
  "discountFixed": "string",
  "tierCodes": [
    "string"
  ],
  "usageCap": 0,
  "perBuyerCap": 0,
  "validFrom": "2026-09-25T10:00:00Z",
  "validTo": "2026-09-25T10:00:00Z"
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "kind": "PROMO",
    "discountPercent": "string",
    "discountFixed": "string",
    "tierCodes": [
      "string"
    ],
    "usageCap": 0,
    "used": 0,
    "perBuyerCap": 0,
    "validFrom": "2026-09-25T10:00:00Z",
    "validTo": "2026-09-25T10:00:00Z"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Issue complimentary tickets from a COMP tier to a Bridge user (OWNER or MANAGER)

POST /ticketing/occurrence/{reference}/comp

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: CompRequest · Response: GenericResponseOrderResponse

curl -X POST "https://api.bridgemoni.com/ticketing/occurrence/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/comp" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "tierCode": "string",
  "quantity": 0,
  "recipientUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "attendeeName": "string"
}'

{
  "tierCode": "string",
  "quantity": 0,
  "recipientUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "attendeeName": "string"
}

{
  "data": {
    "orderReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "holdReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "eventReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "status": "AWAITING_PAYMENT",
    "buyerKind": "USER",
    "paymentSource": "WALLET",
    "faceTotal": "string",
    "feeTotal": "string",
    "discountTotal": "string",
    "total": "string",
    "refundedTotal": "string",
    "currency": "string",
    "paymentCode": "string",
    "repeatOfOrderReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "tickets": [
      {
        "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "tierCode": "string",
        "generation": 0,
        "status": "ISSUED"
      }
    ],
    "creationDateTime": "2026-09-25T10:00:00Z",
    "paidAt": "2026-09-25T10:00:00Z"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Release a rotating ticket's seed to your linked device

GET /ticketing/ticket/{reference}/rotation-seed

Only for ROTATING occurrences, only to an active device linked to the holder, and only within the release window before doors.

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseRotationSeedResponse

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

{
  "data": {
    "ticketReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "generation": 0,
    "rotationSeed": "string",
    "stepSeconds": 0,
    "releasedUntil": "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