API reference · Platform & integration

Ticketing public

GET Ticket verification keys (JWKS form) for third-party scanners

GET /ticketing/public/{tenantId}/credential/keys

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For

Path parameters

Name
tenantId

Example

Response: GenericResponseVerificationKeySet

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

Responses

StatusWhen
200OK

GET Browse events (no session; tenant from the path)

GET /ticketing/public/{tenantId}/event

One row per event with its next occurrence. Filters: q, city, category, from/to, currency with minPrice/maxPrice (all-in), free, near=lat,lon with radiusKm (at most 100), paymentMethod; sort START_ASC, PRICE_ASC, DISTANCE or RELEVANCE.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For

Path parameters

Name
tenantId

Query parameters

NameDefault
qOptional
cityOptional
categoryOptional
fromOptional
toOptional
currencyOptional
minPriceOptional
maxPriceOptional
freeOptional
nearOptional
radiusKmOptional
paymentMethodOptional
sortOptional
page0
size20

Example

Response: GenericResponseDiscoveryPageResponse

curl -X GET "https://api.bridgemoni.com/ticketing/public/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/event?page=value&size=20" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200OK

GET An event page (no session; tenant from the path)

GET /ticketing/public/{tenantId}/event/{reference}

Occurrences, public tiers with all-in prices, payment methods and the account name a bank-transfer payer should expect. Never the account number.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For

Path parameters

Name
tenantId
reference

Example

Response: GenericResponseEventResponse

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

Responses

StatusWhen
200OK

POST Hold tickets as a guest with the code sent to your phone

POST /ticketing/public/{tenantId}/guest/hold

The response carries a guestSession for paying and checking this one hold.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For
Content-Typeapplication/json

Path parameters

Name
tenantId

Example

Request body: GuestHoldRequest · Response: GenericResponseHoldResponse

curl -X POST "https://api.bridgemoni.com/ticketing/public/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/guest/hold" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "phone": "+2348000000000",
  "otp": "string",
  "displayName": "string",
  "email": "ada@example.com",
  "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "lines": [
    {
      "tierReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "tierCode": "string",
      "quantity": 0,
      "seatReferences": [
        "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
      ]
    }
  ],
  "promoCode": "string"
}'

Responses

StatusWhen
200OK

POST Bank-transfer instructions for a guest hold (X-Guest-Session)

POST /ticketing/public/{tenantId}/guest/order/{hold}/pay/bank-transfer

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Guest-Session
X-Forwarded-For
Content-Typeapplication/json

Path parameters

Name
tenantId
hold

Example

Request body: BankTransferRequest · Response: GenericResponseBankTransferInstructions

curl -X POST "https://api.bridgemoni.com/ticketing/public/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/guest/order/value/pay/bank-transfer" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "termsHash": "string"
}'

Responses

StatusWhen
200OK

GET A guest order's status (X-Guest-Session)

GET /ticketing/public/{tenantId}/guest/order/{reference}

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Guest-Session
X-Forwarded-For

Path parameters

Name
tenantId
reference

Example

Response: GenericResponseGuestOrderStatusResponse

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

Responses

StatusWhen
200OK

POST Send a checkout code to a guest's phone

POST /ticketing/public/{tenantId}/guest/otp

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For
Content-Typeapplication/json

Path parameters

Name
tenantId

Example

Request body: GuestOtpRequest · Response: GenericResponseGuestOtpResponse

curl -X POST "https://api.bridgemoni.com/ticketing/public/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/guest/otp" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "phone": "+2348000000000",
  "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}'

Responses

StatusWhen
200OK

GET What's on: one row per occurrence (no session; tenant from the path)

GET /ticketing/public/{tenantId}/occurrence

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For

Path parameters

Name
tenantId

Query parameters

NameDefault
qOptional
cityOptional
categoryOptional
fromOptional
toOptional
currencyOptional
nearOptional
radiusKmOptional
sortOptional
page0
size20

Example

Response: GenericResponseDiscoveryPageResponse

curl -X GET "https://api.bridgemoni.com/ticketing/public/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/occurrence?page=value&size=20" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200OK

GET Tier availability bands for an occurrence; never exact counts

GET /ticketing/public/{tenantId}/occurrence/{reference}/availability

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For

Path parameters

Name
tenantId
reference

Example

Response: GenericResponseAvailabilityResponse

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

Responses

StatusWhen
200OK

GET Seats of a seated occurrence; held seats show as unavailable

GET /ticketing/public/{tenantId}/occurrence/{reference}/seats

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For

Path parameters

Name
tenantId
reference

Example

Response: GenericResponseListSeatResponse

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

Responses

StatusWhen
200OK

POST Resend your pass links; the old links stop working

POST /ticketing/public/{tenantId}/pass/resend

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For
Content-Typeapplication/json

Path parameters

Name
tenantId

Example

Request body: PassResendRequest · Response: GenericResponsePassResponse

curl -X POST "https://api.bridgemoni.com/ticketing/public/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/pass/resend" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "phone": "+2348000000000",
  "otp": "string"
}'

Responses

StatusWhen
200OK

POST Send a code to resend your passes

POST /ticketing/public/{tenantId}/pass/resend/otp

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For
Content-Typeapplication/json

Path parameters

Name
tenantId

Example

Request body: GuestOtpRequest · Response: GenericResponseGuestOtpResponse

curl -X POST "https://api.bridgemoni.com/ticketing/public/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/pass/resend/otp" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "phone": "+2348000000000",
  "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}'

Responses

StatusWhen
200OK

GET Open a guest pass

GET /ticketing/public/{tenantId}/pass/{token}

Shows the tickets; the QR codes appear only with an unlock session (X-Pass-Session).

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Pass-Session
X-Forwarded-For

Path parameters

Name
tenantId
token

Example

Response: GenericResponsePassResponse

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

Responses

StatusWhen
200OK

POST Report a pass lost or stolen

POST /ticketing/public/{tenantId}/pass/{token}/lost

Revokes the link and reissues every ticket at the next generation; a new link is sent by SMS.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Pass-Session
X-Forwarded-For

Path parameters

Name
tenantId
token

Example

Response: GenericResponsePassResponse

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

Responses

StatusWhen
200OK

POST Unlock a pass on this browser with the code sent to its phone

POST /ticketing/public/{tenantId}/pass/{token}/unlock

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For
Content-Typeapplication/json

Path parameters

Name
tenantId
token

Example

Request body: PassUnlockRequest · Response: GenericResponsePassUnlockResponse

curl -X POST "https://api.bridgemoni.com/ticketing/public/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/pass/value/unlock" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "otp": "string"
}'

Responses

StatusWhen
200OK

POST Send an unlock code to the pass's phone

POST /ticketing/public/{tenantId}/pass/{token}/unlock/otp

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
X-Forwarded-For

Path parameters

Name
tenantId
token

Example

Response: GenericResponseGuestOtpResponse

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

Responses

StatusWhen
200OK

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