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.
Ticket reservation ID.
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.
Date and time the ticket reservation was created.
Date and time the ticket reservation was updated.
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.
Reservation status.
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.
ID of the site visitor who created this reservation.
Returned for both logged-in members and anonymous visitors.
Learn more about identities.
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.
Advanced configuration options that modify default reservation behavior.
Use these settings to override standard validation rules, such as availability limits or hidden ticket restrictions.
Extended fields allow you to add custom properties beyond the standard reservation data.
Learn more about extended fields.
Tags allow you to classify ticket reservations.
Learn more about tags.