Create an event ticket from a booking

POST /event-tickets/create-from-booking

Creates an event ticket for a non-member recipient from cinema or booking-system data. Requires the passes:issue permission.

Note

Use this endpoint when the ticket recipient is not a RemyPass member. The API creates or reuses an event ticket template for the film and start time, creates the ticket pass instance, and prevents duplicate bookings by rejecting requests with a bookingId that already exists.

Authorization

X-API-Key required

Request Body

Field	Type	Required	Description
`bookingId`	string	Yes	External booking or order identifier for the ticket. Must be unique; duplicate booking IDs are rejected.
`film`	string	Yes	Event or film name to display on the ticket.
`sendEmail`	boolean	No	Defaults to false. Set to true to send the ticket email after creation.
`startTime`	string (date-time)	Yes	Event start time in ISO 8601 format.
`seat`	string	Yes	Seat number or seat label.
`row`	string	Yes	Seat row.
`screen`	string	Yes	Screen, room, section, or venue area.
`customer`	object	Yes	Customer details for the ticket recipient.

Request Examples

curl -X POST "https://api.remypass.com/api/v1/public/event-tickets/create-from-booking" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "bookingId": "BOOKING-12345",
  "film": "The Matrix Reloaded",
  "sendEmail": true,
  "startTime": "2024-12-25T19:30:00.000Z",
  "seat": "A12",
  "row": "A",
  "screen": "Screen 1",
  "customer": {
    "name": "John Doe",
    "email": "john@example.com"
  }
}'

Use Case Examples

Create event ticket from booking for a non-member

Use this for cinema or booking-system integrations where the recipient is not a member. The API automatically creates templates and prevents duplicate bookings.

curl -X POST https://api.remypass.com/api/v1/public/event-tickets/create-from-booking \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bookingId": "BOOKING-12345",
    "film": "The Matrix Reloaded",
    "sendEmail": true,
    "startTime": "2024-12-25T19:30:00.000Z",
    "seat": "A12",
    "row": "A",
    "screen": "Screen 1",
    "customer": {
      "name": "John Doe",
      "email": "john@example.com"
    }
  }'

Responses

Status	Description
`201`	Event ticket created.
`400`	Bad request or validation error.
`401`	Missing or invalid API key.
`403`	The caller is not allowed to access this resource.
`500`	Server error.

Response Fields

Field	Type	Attributes
`success`	boolean
`message`	string
`data`	object	Show child attributes `passInstance`: object Show child attributes `_id`: string `serialNumber`: string `status`: active, inactive, expired, void `member`: string or object Show child attributes `_id`: string `title`: Mr, Ms, Mrs, Miss, Sir, Madam, Dr, Rev `name`: string `email`: string (email) `memberId`: string `type`: Member, Visitor `status`: active, inactive `customFields`: object `passes`: integer `createdAt`: string (date-time) `updatedAt`: string (date-time) `pass`: string or object Show child attributes `_id`: string `name`: string `description`: string `type`: string `approved`: boolean `design`: object `loyalty`: object `recipientName`: string `recipientEmail`: string (email) `expiryDate`: string (date-time) `issuedAt`: string (date-time) `walletUrls`: object Show child attributes `apple`: string (uri) `google`: string (uri) `walletUrls`: object Show child attributes `apple`: string (uri) `google`: string (uri) `emailSent`: boolean `message`: string

Authorization​

Request Body​

Request Examples​

Use Case Examples​

Create event ticket from booking for a non-member​

Responses​

Response Fields​