Skip to main content
GET
Get a reservation
Returns one reservation, in the same shape List Reservations returns.

Authorizations

Authorization
string
header
required

Your API key. See Authorization to create one.

Path Parameters

venueId
string
required

The venue being addressed. Every endpoint on this API is venue-scoped.

Minimum string length: 1
Example:

"6247"

id
string
required

The reservation's id — not its bookingRef.

Minimum string length: 1
Example:

"booking_2026-08-24_G3F7PA8HO438Z_1787294227662"

Response

The reservation.

A reservation. Absent optional fields are omitted from the JSON rather than sent as null or [].

id
string
required

The identifier that addresses this reservation.

Example:

"booking_2026-08-24_G3F7PA8HO438Z_1787294227662"

bookingDateTime
string
required

Venue-local wall clock, ISO formatted. Not an absolute instant.

Example:

"2026-08-24T14:00:00"

partySize
integer
required
Example:

2

tableIds
string[]
required

The tables allocated. Empty only for a standby or waitlist entry.

tagIds
string[]
required
optionsSelected
object[]
required

Booking options the guest chose, with the prices that determined what was payable.

paymentDetails
object
required

Where the reservation stands on payment. Always present, including for reservations that take no payment.

bookingRef
string

The reference you quote to a guest. A different identifier from id, and not usable as a path parameter.

Example:

"94227662"

status
enum<string>

The status code the reservation carries, joining onto the reservation-statuses endpoint's code. U unconfirmed, P$ pending payment, C confirmed, X cancelled, NS cancelled no-show, S seated, F finished, SP standby pending, TX SMS sent or SMS failed.

Several statuses can share one code, so treat code as a coarse grouping and statusId as the precise value. Venues can add statuses of their own, so read the venue's own set from the reservation-statuses endpoint rather than assuming this list is closed.

Available options:
U,
P$,
C,
X,
NS,
S,
F,
SP,
TX
statusId
string

The status's id. Several statuses can share one code, so this is what identifies the status the reservation is in — and the value a patch sets status to.

Example:

"status_seated_main"

reservationType
enum<string>

A standby or waitlist entry is the same kind of record as a confirmed booking.

Available options:
Booking,
WaitList,
StandbyList
durationMinutes
integer
Example:

120

service
object
diner
object

Guest details recorded on the reservation.

requestedSectionId
string

The section the reservation asked for, which is often not where the allocated table sits. Absent when no preference was given.

movedFromBookingId
string

The reservation this one replaced, set when a reservation was moved to another calendar date. The same id coming back means an ordinary change; a new id with this set means a replacement, and the value names the reservation to stop tracking.

Example:

"booking_2026-08-24_G3F7PA8HO438Z_1787294227662"

notes
string
source
string

Originating channel. Read-only — set from your credential when the reservation is created.

Example:

"online"

createdAt
string<date-time>

When the reservation was made. An absolute instant, unlike bookingDateTime.

updatedAt
string<date-time>