Ticket Reservation Object


A ticket reservation holds tickets for a specified time period during the checkout process.

When a site visitor selects tickets for an event, a ticket reservation is created to temporarily reserve those tickets while the visitor completes their purchase. The reservation prevents other visitors from purchasing the same tickets and includes pricing, seat information (if applicable), and an expiration time.

Properties
idstringRead-onlyformat GUID

Ticket reservation ID.


revisionstringRead-onlyformat int64

Revision number, which increments by 1 each time the ticket reservation is updated. To prevent conflicting changes, the current revision must be passed when updating the ticket reservation.


createdDatestringRead-onlyformat date-time

Date and time the ticket reservation was created.


updatedDatestringRead-onlyformat date-time

Date and time the ticket reservation was updated.


expirationDatestringRead-onlyformat date-time

Date and time when a PENDING ticket reservation will automatically expire if not confirmed.

When a reservation expires, tickets are released back to the available inventory. Expiration time is calculated based on the event's reservation duration settings. To set the reservation duration, call Create Event API.

Note: This field only applies to PENDING reservations.


statusstringRead-only

Reservation status.


memberIdstringRead-onlyformat GUID

ID of the site member who created this reservation.

Only returned when the reservation was created by a logged-in site member.

Learn more about identities.


visitorIdstringRead-onlyformat GUID

ID of the site visitor who created this reservation.

Returned for both logged-in members and anonymous visitors.

Learn more about identities.


ticketsArray <TicketLineItem>minItems 1maxItems 50

List of ticket line items included in this reservation.

Each line item represents tickets of the same type, pricing option, and seating arrangement. Multiple line items are created when reserving different ticket types or seating sections.


additionalReservationSettingsAdditionalReservationSettingsimmutable

Advanced configuration options that modify default reservation behavior.

Use these settings to override standard validation rules, such as availability limits or hidden ticket restrictions.


extendedFieldsExtendedFields

Extended fields allow you to add custom properties beyond the standard reservation data.

Learn more about extended fields.


tagsTags

Tags allow you to classify ticket reservations.

Learn more about tags.

Did this help?