Create Ticket Reservation

POST /ticket-reservations

Creates a temporary reservation for a ticket. The reservation holds capacity in a time slot (if specified) for 15 minutes while the customer completes checkout.

Use this endpoint when you need to reserve a spot before creating the actual ticket, especially for time-slotted tickets where capacity is limited.

Request Parameters

Property	Type	Description
`ticketTypeId`*	`string` (UUIDv4)	ID of the ticket type to reserve
`timeSlotId`	`string` (UUIDv4)	ID of the time slot to reserve capacity in. The ticket type and time slot must belong to the same location (or both have no location).

Example Request


Copy
{
  "ticketTypeId": "bd4a0997-39db-41d9-883a-cdfa83e2101f",
  "timeSlotId": "c6062aa8-40eb-52e0-9af2-e5e193e3102g"
}

Example Response


Copy
{
  "id": "aB3xY9kLmN2pQ5rS8tU1vW4xY7zA0bC3dE6fG9hI2jK5lM8nO1pQ4rS7tU0vW3xY6zA9bC2dE5fG8hI1jK4lM7nO0pQ3rS6tU9vW2xY5zA8bC1dE4fG7hI0jK3lM6n",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "expiresAt": "2024-01-15T10:45:00.000Z"
}

Error Codes

Error Code	Description
`TICKET_TYPE_ID_MISSING`	The `ticketTypeId` field is required
`TICKET_TYPE_NOT_FOUND`	The ticket type does not exist or does not belong to your workspace
`TIME_SLOT_NOT_EXIST`	The time slot does not exist or does not match the ticket type's location
`TIME_SLOT_FULL`	The time slot has reached its maximum capacity

Next Steps

After creating a reservation, use the POST /tickets endpoint with the ticketReservationId parameter to convert the reservation into an actual ticket.