API reference · Platform & integration

Ticketing buyer

POST/ticketing/holdReserve tickets for a few minutes while you pay
DELETE/ticketing/hold/{reference}Release one of your holds
GET/ticketing/hold/{reference}Get one of your holds
DELETE/ticketing/me/calendar-feedRevoke your calendar subscription link
POST/ticketing/me/calendar-feedCreate or rotate your calendar subscription link
GET/ticketing/me/event/{reference}Your view of an event: schedule state, reminders, tickets held, active hold
POST/ticketing/me/pass/claimMove guest passes bought with your verified phone number into your account
GET/ticketing/me/scheduleYour timeline: occurrences you are going to and ones you saved
POST/ticketing/me/scheduleSave an occurrence to your schedule, optionally with reminders
DELETE/ticketing/me/schedule/{occurrence}Remove an interested occurrence from your schedule; a ticket keeps it there
PUT/ticketing/me/schedule/{occurrence}/remindersReplace your reminders for an occurrence
GET/ticketing/occurrence/{reference}/resaleResale listings for an occurrence, cheapest first
GET/ticketing/order/mineYour orders, newest first, at most 100 a page
POST/ticketing/order/{hold}/confirmConfirm a free hold; no payment is taken
POST/ticketing/order/{hold}/pay/bank-transferPay for a hold by bank transfer to the event's account
POST/ticketing/order/{hold}/pay/walletPay for a hold from your Bridge wallet (PIN)
GET/ticketing/order/{reference}One of your orders
GET/ticketing/public/{tenantId}/calendar/{token}.icsA calendar subscription (capability URL; never carries tickets)
GET/ticketing/public/{tenantId}/occurrence/{reference}/calendar.icsAdd one occurrence to a calendar (public data only)
DELETE/ticketing/resale/{reference}Withdraw a resale listing
POST/ticketing/resale/{reference}/holdHold a resale listing while you pay for it by wallet
GET/ticketing/ticket/mineYour tickets with their credentials
POST/ticketing/ticket/{reference}/resaleList a ticket on the face-value exchange
POST/ticketing/ticket/{reference}/transferOffer a ticket to someone by phone number
GET/ticketing/transfer/incomingTransfers waiting for you to accept
POST/ticketing/transfer/{reference}/acceptAccept a transfer offered to your phone number; the ticket is reissued to you
POST/ticketing/transfer/{reference}/cancelWithdraw a transfer you offered

POST Reserve tickets for a few minutes while you pay

POST /ticketing/hold

One currency per hold. Capacity is taken by a single conditional update, so a hold either gets every ticket asked for or none. A second request for the same occurrence returns the hold you already have.

Headers

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

Example

Request body: HoldRequest · Response: GenericResponseHoldResponse

curl -X POST "https://api.bridgemoni.com/ticketing/hold" \
  -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"
      ]
    }
  ],
  "promoCode": "string",
  "accessCode": "string",
  "admissionToken": "string"
}'

{
  "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",
  "accessCode": "string",
  "admissionToken": "string"
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "eventReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "status": "ACTIVE",
    "expiresAt": "2026-09-25T10:00:00Z",
    "lines": [
      {
        "tierReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "tierCode": "string",
        "quantity": 0,
        "unitFace": "string",
        "unitFee": "string",
        "unitDiscount": "string",
        "unitTotal": "string"
      }
    ],
    "charges": [
      {
        "type": "string",
        "code": "string",
        "amount": "string"
      }
    ],
    "subtotal": "string",
    "total": "string",
    "currency": "string",
    "termsHash": "string",
    "paymentMethods": [
      "BRIDGE_WALLET"
    ],
    "guestSession": "string"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

DELETE Release one of your holds

DELETE /ticketing/hold/{reference}

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseHoldResponse

curl -X DELETE "https://api.bridgemoni.com/ticketing/hold/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",
    "eventReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "status": "ACTIVE",
    "expiresAt": "2026-09-25T10:00:00Z",
    "lines": [
      {
        "tierReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "tierCode": "string",
        "quantity": 0,
        "unitFace": "string",
        "unitFee": "string",
        "unitDiscount": "string",
        "unitTotal": "string"
      }
    ],
    "charges": [
      {
        "type": "string",
        "code": "string",
        "amount": "string"
      }
    ],
    "subtotal": "string",
    "total": "string",
    "currency": "string",
    "termsHash": "string",
    "paymentMethods": [
      "BRIDGE_WALLET"
    ],
    "guestSession": "string"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Get one of your holds

GET /ticketing/hold/{reference}

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseHoldResponse

curl -X GET "https://api.bridgemoni.com/ticketing/hold/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",
    "eventReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "status": "ACTIVE",
    "expiresAt": "2026-09-25T10:00:00Z",
    "lines": [
      {
        "tierReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "tierCode": "string",
        "quantity": 0,
        "unitFace": "string",
        "unitFee": "string",
        "unitDiscount": "string",
        "unitTotal": "string"
      }
    ],
    "charges": [
      {
        "type": "string",
        "code": "string",
        "amount": "string"
      }
    ],
    "subtotal": "string",
    "total": "string",
    "currency": "string",
    "termsHash": "string",
    "paymentMethods": [
      "BRIDGE_WALLET"
    ],
    "guestSession": "string"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

DELETE Revoke your calendar subscription link

DELETE /ticketing/me/calendar-feed

Headers

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

Example

Response: GenericResponseBoolean

curl -X DELETE "https://api.bridgemoni.com/ticketing/me/calendar-feed" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": true,
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Create or rotate your calendar subscription link

POST /ticketing/me/calendar-feed

The link is shown once. Creating it again kills the old link.

Headers

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

Example

Response: GenericResponseCalendarFeedResponse

curl -X POST "https://api.bridgemoni.com/ticketing/me/calendar-feed" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "url": "string",
    "createdAt": "2026-09-25T10:00:00Z",
    "lastFetchedAt": "2026-09-25T10:00:00Z",
    "status": "ACTIVE"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Your view of an event: schedule state, reminders, tickets held, active hold

GET /ticketing/me/event/{reference}

Never cached. walletPayable is true when you have a wallet in the occurrence's currency.

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseMeEventResponse

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

{
  "data": {
    "eventReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrences": [
      {
        "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "scheduleState": "GOING",
        "reminders": [
          {
            "kind": "ON_SALE",
            "offsetMinutes": 0
          }
        ],
        "ticketsHeld": 0,
        "activeHold": {
          "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
          "expiresAt": "2026-09-25T10:00:00Z"
        },
        "walletPayable": true
      }
    ]
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Move guest passes bought with your verified phone number into your account

POST /ticketing/me/pass/claim

Each ticket is reissued to you at the next generation, so the browser QR codes stop working.

Headers

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

Example

Response: GenericResponsePassClaimResponse

curl -X POST "https://api.bridgemoni.com/ticketing/me/pass/claim" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "passesClaimed": 0,
    "ticketsClaimed": 0
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Your timeline: occurrences you are going to and ones you saved

GET /ticketing/me/schedule

Headers

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

Query parameters

Name	Default
`from`	Optional
`to`	Optional

Example

Response: GenericResponseTimelineResponse

curl -X GET "https://api.bridgemoni.com/ticketing/me/schedule" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "from": "2026-09-25T10:00:00Z",
    "to": "2026-09-25T10:00:00Z",
    "items": [
      {
        "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "eventReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "title": "string",
        "venue": {
          "name": "string",
          "city": "string"
        },
        "startsAt": "2026-09-25T10:00:00Z",
        "doorsAt": "2026-09-25T10:00:00Z",
        "timezone": "string",
        "state": "GOING",
        "ticketsHeld": 0,
        "status": "DRAFT",
        "changedSinceAdded": {
          "originalStartsAt": "2026-09-25T10:00:00Z",
          "postponementRefundWindowEndsAt": "2026-09-25T10:00:00Z"
        },
        "onSaleAt": "2026-09-25T10:00:00Z",
        "reminders": [
          {
            "kind": "ON_SALE",
            "offsetMinutes": 0,
            "nextAt": "2026-09-25T10:00:00Z"
          }
        ]
      }
    ]
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Save an occurrence to your schedule, optionally with reminders

POST /ticketing/me/schedule

Headers

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

Example

Request body: ScheduleSaveRequest · Response: GenericResponseTimelineItem

curl -X POST "https://api.bridgemoni.com/ticketing/me/schedule" \
  -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",
  "reminders": [
    {
      "kind": "ON_SALE",
      "offsetMinutes": 0
    }
  ]
}'

{
  "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "reminders": [
    {
      "kind": "ON_SALE",
      "offsetMinutes": 0
    }
  ]
}

{
  "data": {
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "eventReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "title": "string",
    "venue": {
      "name": "string",
      "city": "string"
    },
    "startsAt": "2026-09-25T10:00:00Z",
    "doorsAt": "2026-09-25T10:00:00Z",
    "timezone": "string",
    "state": "GOING",
    "ticketsHeld": 0,
    "status": "DRAFT",
    "changedSinceAdded": {
      "originalStartsAt": "2026-09-25T10:00:00Z",
      "postponementRefundWindowEndsAt": "2026-09-25T10:00:00Z"
    },
    "onSaleAt": "2026-09-25T10:00:00Z",
    "reminders": [
      {
        "kind": "ON_SALE",
        "offsetMinutes": 0,
        "nextAt": "2026-09-25T10:00:00Z"
      }
    ]
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

DELETE Remove an interested occurrence from your schedule; a ticket keeps it there

DELETE /ticketing/me/schedule/{occurrence}

Headers

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

Path parameters

Name
`occurrence`

Example

Response: GenericResponseBoolean

curl -X DELETE "https://api.bridgemoni.com/ticketing/me/schedule/value" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": true,
  "description": "OK"
}

Responses

Status	When
`200`	OK

PUT Replace your reminders for an occurrence

PUT /ticketing/me/schedule/{occurrence}/reminders

ON_SALE, or BEFORE_START at 60, 180, 1440 or 10080 minutes. Due times follow the occurrence if it moves.

Headers

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

Path parameters

Name
`occurrence`

Example

Request body: ScheduleRemindersRequest · Response: GenericResponseTimelineItem

curl -X PUT "https://api.bridgemoni.com/ticketing/me/schedule/value/reminders" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "reminders": [
    {
      "kind": "ON_SALE",
      "offsetMinutes": 0
    }
  ]
}'

{
  "reminders": [
    {
      "kind": "ON_SALE",
      "offsetMinutes": 0
    }
  ]
}

{
  "data": {
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "eventReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "title": "string",
    "venue": {
      "name": "string",
      "city": "string"
    },
    "startsAt": "2026-09-25T10:00:00Z",
    "doorsAt": "2026-09-25T10:00:00Z",
    "timezone": "string",
    "state": "GOING",
    "ticketsHeld": 0,
    "status": "DRAFT",
    "changedSinceAdded": {
      "originalStartsAt": "2026-09-25T10:00:00Z",
      "postponementRefundWindowEndsAt": "2026-09-25T10:00:00Z"
    },
    "onSaleAt": "2026-09-25T10:00:00Z",
    "reminders": [
      {
        "kind": "ON_SALE",
        "offsetMinutes": 0,
        "nextAt": "2026-09-25T10:00:00Z"
      }
    ]
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Resale listings for an occurrence, cheapest first

GET /ticketing/occurrence/{reference}/resale

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseListResaleListingResponse

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

{
  "data": [
    {
      "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "ticketReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "tierCode": "string",
      "price": "string",
      "faceValue": "string",
      "capPrice": "string",
      "currency": "string",
      "status": "LISTED"
    }
  ],
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Your orders, newest first, at most 100 a page

GET /ticketing/order/mine

Headers

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

Query parameters

Name	Default
`page`	0
`size`	20

Example

Response: GenericResponseListOrderResponse

curl -X GET "https://api.bridgemoni.com/ticketing/order/mine?page=value&size=20" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "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

POST Confirm a free hold; no payment is taken

POST /ticketing/order/{hold}/confirm

Headers

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

Path parameters

Name
`hold`

Example

Response: GenericResponseOrderResponse

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

{
  "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

POST Pay for a hold by bank transfer to the event's account

POST /ticketing/order/{hold}/pay/bank-transfer

Returns the account numbers, the exact amount and a payment code to put in the narration. Tickets are issued when the transfer arrives.

Headers

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

Path parameters

Name
`hold`

Example

Request body: BankTransferRequest · Response: GenericResponseBankTransferInstructions

curl -X POST "https://api.bridgemoni.com/ticketing/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"
}'

{
  "termsHash": "string"
}

{
  "data": {
    "orderReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "status": "AWAITING_PAYMENT",
    "amount": "string",
    "currencyCode": "string",
    "paymentCode": "string",
    "expiresAt": "2026-09-25T10:00:00Z",
    "accounts": [
      {
        "bankName": "string",
        "accountNumber": "string",
        "accountName": "ADA OKAFOR"
      }
    ],
    "instructions": [
      "string"
    ],
    "statusUrl": "string"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Pay for a hold from your Bridge wallet (PIN)

POST /ticketing/order/{hold}/pay/wallet

Moves the total from your wallet into the event's wallet and issues the tickets in one step. Send the hold's termsHash; a changed tier is refused with 409.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Idempotency-Key`	Reuse the same value on every retry of this request
`Content-Type`	application/json

Path parameters

Name
`hold`

Example

Request body: WalletPaymentRequest · Response: GenericResponseOrderResponse

curl -X POST "https://api.bridgemoni.com/ticketing/order/value/pay/wallet" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "termsHash": "string",
  "sourceAccountNumber": "string"
}'

{
  "termsHash": "string",
  "sourceAccountNumber": "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 One of your orders

GET /ticketing/order/{reference}

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseOrderResponse

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

{
  "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 A calendar subscription (capability URL; never carries tickets)

GET /ticketing/public/{tenantId}/calendar/{token}.ics

Headers

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

Path parameters

Name
`tenantId`
`token`

Example

Response: string

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

"string"

Responses

Status	When
`200`	OK

GET Add one occurrence to a calendar (public data only)

GET /ticketing/public/{tenantId}/occurrence/{reference}/calendar.ics

Headers

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

Path parameters

Name
`tenantId`
`reference`

Example

Response: string

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

"string"

Responses

Status	When
`200`	OK

DELETE Withdraw a resale listing

DELETE /ticketing/resale/{reference}

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseResaleListingResponse

curl -X DELETE "https://api.bridgemoni.com/ticketing/resale/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",
    "ticketReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "tierCode": "string",
    "price": "string",
    "faceValue": "string",
    "capPrice": "string",
    "currency": "string",
    "status": "LISTED"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Hold a resale listing while you pay for it by wallet

POST /ticketing/resale/{reference}/hold

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseHoldResponse

curl -X POST "https://api.bridgemoni.com/ticketing/resale/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/hold" \
  -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",
    "eventReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "status": "ACTIVE",
    "expiresAt": "2026-09-25T10:00:00Z",
    "lines": [
      {
        "tierReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "tierCode": "string",
        "quantity": 0,
        "unitFace": "string",
        "unitFee": "string",
        "unitDiscount": "string",
        "unitTotal": "string"
      }
    ],
    "charges": [
      {
        "type": "string",
        "code": "string",
        "amount": "string"
      }
    ],
    "subtotal": "string",
    "total": "string",
    "currency": "string",
    "termsHash": "string",
    "paymentMethods": [
      "BRIDGE_WALLET"
    ],
    "guestSession": "string"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Your tickets with their credentials

GET /ticketing/ticket/mine

The only place a credential leaves the server. The path is never cached.

Headers

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

Query parameters

Name	Default
`page`	0
`size`	20

Example

Response: GenericResponseTicketPageResponse

curl -X GET "https://api.bridgemoni.com/ticketing/ticket/mine?page=value&size=20" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "page": 0,
    "size": 0,
    "items": [
      {
        "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "orderReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "event": "string",
        "occurrence": {
          "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
          "startsAt": "2026-09-25T10:00:00Z",
          "timezone": "string",
          "venue": "string"
        },
        "tierCode": "string",
        "seat": "string",
        "status": "ISSUED",
        "generation": 0,
        "credentialMode": "STATIC",
        "credential": "string",
        "restricted": true,
        "transferable": true,
        "transferClosesAt": "2026-09-25T10:00:00Z"
      }
    ]
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST List a ticket on the face-value exchange

POST /ticketing/ticket/{reference}/resale

The price may not exceed face value plus the tier's resale cap. The seller is paid after the event.

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: ResaleListingRequest · Response: GenericResponseResaleListingResponse

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

{
  "price": "string"
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "ticketReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "occurrenceReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "tierCode": "string",
    "price": "string",
    "faceValue": "string",
    "capPrice": "string",
    "currency": "string",
    "status": "LISTED"
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Offer a ticket to someone by phone number

POST /ticketing/ticket/{reference}/transfer

The ticket stops scanning until the offer is accepted, cancelled or lapses. The response never says whether the number is a Bridge user.

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: TransferRequest · Response: GenericResponseTransferResponse

curl -X POST "https://api.bridgemoni.com/ticketing/ticket/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/transfer" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "sourceAccountNumber": 3000000001,
  "instrumentReference": "8c1f0d4e-6b2a-4f7c-9d31-2a5e8b0c7f44",
  "destinationAccountNumber": 3000000002,
  "beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "organizationReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "receiverType": "ACCOUNT_NUMBER",
  "receiverValue": "3000000002",
  "amount": 0,
  "saveBeneficiary": true,
  "beneficiaryAlias": "Landlord",
  "currencyCode": "string",
  "narration": "string",
  "executionMode": "SYNCHRONOUS",
  "schedule": {
    "startDateTime": "2026-09-25T10:00:00Z",
    "frequency": "HOURLY",
    "endDateTime": "2026-09-25T10:00:00Z",
    "maxOccurrences": 0
  }
}'

{
  "sourceAccountNumber": 3000000001,
  "instrumentReference": "8c1f0d4e-6b2a-4f7c-9d31-2a5e8b0c7f44",
  "destinationAccountNumber": 3000000002,
  "beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "organizationReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "receiverType": "ACCOUNT_NUMBER",
  "receiverValue": "3000000002",
  "amount": 0,
  "saveBeneficiary": true,
  "beneficiaryAlias": "Landlord",
  "currencyCode": "string",
  "narration": "string",
  "executionMode": "SYNCHRONOUS",
  "schedule": {
    "startDateTime": "2026-09-25T10:00:00Z",
    "frequency": "HOURLY",
    "endDateTime": "2026-09-25T10:00:00Z",
    "maxOccurrences": 0
  }
}

{
  "data": {
    "transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "sourceAccountNumber": "string",
    "destinationAccountNumber": "string",
    "beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "saveBeneficiaryToken": "string",
    "beneficiaryName": {
      "name": "string"
    },
    "amount": 0,
    "netAmount": 0,
    "currencyCode": "string",
    "status": "PENDING",
    "accountsTransactionReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "scheduleReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "approvalReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "timestamp": "2026-09-25T10:00:00Z",
    "charges": [
      {
        "pricingRuleReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "name": {
          "name": "string"
        },
        "category": "FEE",
        "amount": 0
      }
    ],
    "totalFees": 0,
    "totalTaxes": 0,
    "totalLevies": 0
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Transfers waiting for you to accept

GET /ticketing/transfer/incoming

Headers

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

Example

Response: GenericResponseListTransferResponse

curl -X GET "https://api.bridgemoni.com/ticketing/transfer/incoming" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": [
    {
      "transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "sourceAccountNumber": "string",
      "destinationAccountNumber": "string",
      "beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "saveBeneficiaryToken": "string",
      "beneficiaryName": {
        "name": "string"
      },
      "amount": 0,
      "netAmount": 0,
      "currencyCode": "string",
      "status": "PENDING",
      "accountsTransactionReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "scheduleReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "approvalReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "timestamp": "2026-09-25T10:00:00Z",
      "charges": [
        {
          "pricingRuleReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
          "name": {
            "name": "string"
          },
          "category": "FEE",
          "amount": 0
        }
      ],
      "totalFees": 0,
      "totalTaxes": 0,
      "totalLevies": 0
    }
  ],
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Accept a transfer offered to your phone number; the ticket is reissued to you

POST /ticketing/transfer/{reference}/accept

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseTransferResponse

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

{
  "data": {
    "transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "sourceAccountNumber": "string",
    "destinationAccountNumber": "string",
    "beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "saveBeneficiaryToken": "string",
    "beneficiaryName": {
      "name": "string"
    },
    "amount": 0,
    "netAmount": 0,
    "currencyCode": "string",
    "status": "PENDING",
    "accountsTransactionReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "scheduleReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "approvalReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "timestamp": "2026-09-25T10:00:00Z",
    "charges": [
      {
        "pricingRuleReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "name": {
          "name": "string"
        },
        "category": "FEE",
        "amount": 0
      }
    ],
    "totalFees": 0,
    "totalTaxes": 0,
    "totalLevies": 0
  },
  "description": "OK"
}

Responses

Status	When
`200`	OK

POST Withdraw a transfer you offered

POST /ticketing/transfer/{reference}/cancel

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseTransferResponse

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

{
  "data": {
    "transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "sourceAccountNumber": "string",
    "destinationAccountNumber": "string",
    "beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "saveBeneficiaryToken": "string",
    "beneficiaryName": {
      "name": "string"
    },
    "amount": 0,
    "netAmount": 0,
    "currencyCode": "string",
    "status": "PENDING",
    "accountsTransactionReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "scheduleReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "approvalReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "timestamp": "2026-09-25T10:00:00Z",
    "charges": [
      {
        "pricingRuleReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "name": {
          "name": "string"
        },
        "category": "FEE",
        "amount": 0
      }
    ],
    "totalFees": 0,
    "totalTaxes": 0,
    "totalLevies": 0
  },
  "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