curl --request GET \
--url https://platform.uat.nowbookit.com/api/reservations/venue/{venueId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "booking_2026-09-01_G3F7PA8HO438Z_1787294227662",
"bookingRef": "94227662",
"status": "C",
"statusId": "status_confirmed",
"reservationType": "Booking",
"bookingDateTime": "2026-09-01T18:30:00",
"durationMinutes": 120,
"partySize": 2,
"service": {
"id": "service_dinner",
"name": "Dinner"
},
"diner": {
"id": "customer_9f2a1c",
"firstName": "Alex",
"lastName": "Chen",
"email": "[email protected]",
"phone": "+61400000000"
},
"tableIds": [
"table_12"
],
"requestedSectionId": "section_main",
"tagIds": [
"tag_birthday"
],
"optionsSelected": [
{
"id": "menuoption_set_menu",
"name": "Set Menu",
"unitPrice": 2500,
"quantity": 2,
"paymentType": "Deposit",
"isUpsell": false
}
],
"paymentDetails": {
"paymentType": "Deposit",
"pricingType": "PerPerson",
"currency": "AUD",
"total": 5000,
"paid": 5000,
"state": "Paid",
"transactionId": "pi_3Qw1xyz",
"paidAt": "2026-08-24T04:15:22.481Z"
},
"notes": "Window table if possible",
"source": "online",
"createdAt": "2026-08-24T04:15:20.104Z",
"updatedAt": "2026-08-24T04:15:22.900Z"
}
]{
"code": "ValidationError",
"message": "Query parameters failed validation",
"requestId": "0f1c9f2e-4b8a-4c1e-9d33-2a7f5b1c8e90",
"errors": {
"partySize": [
"partySize must be at least 1"
],
"endDate": [
"endDate must be on or after startDate"
]
}
}{
"code": "NotFoundError",
"message": "Venue not found: 6247",
"requestId": "0f1c9f2e-4b8a-4c1e-9d33-2a7f5b1c8e90"
}{
"code": "InternalError",
"message": "Internal server error",
"requestId": "0f1c9f2e-4b8a-4c1e-9d33-2a7f5b1c8e90"
}List Reservations
A venue’s reservations over a calendar-date range.
curl --request GET \
--url https://platform.uat.nowbookit.com/api/reservations/venue/{venueId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.uat.nowbookit.com/api/reservations/venue/{venueId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "booking_2026-09-01_G3F7PA8HO438Z_1787294227662",
"bookingRef": "94227662",
"status": "C",
"statusId": "status_confirmed",
"reservationType": "Booking",
"bookingDateTime": "2026-09-01T18:30:00",
"durationMinutes": 120,
"partySize": 2,
"service": {
"id": "service_dinner",
"name": "Dinner"
},
"diner": {
"id": "customer_9f2a1c",
"firstName": "Alex",
"lastName": "Chen",
"email": "[email protected]",
"phone": "+61400000000"
},
"tableIds": [
"table_12"
],
"requestedSectionId": "section_main",
"tagIds": [
"tag_birthday"
],
"optionsSelected": [
{
"id": "menuoption_set_menu",
"name": "Set Menu",
"unitPrice": 2500,
"quantity": 2,
"paymentType": "Deposit",
"isUpsell": false
}
],
"paymentDetails": {
"paymentType": "Deposit",
"pricingType": "PerPerson",
"currency": "AUD",
"total": 5000,
"paid": 5000,
"state": "Paid",
"transactionId": "pi_3Qw1xyz",
"paidAt": "2026-08-24T04:15:22.481Z"
},
"notes": "Window table if possible",
"source": "online",
"createdAt": "2026-08-24T04:15:20.104Z",
"updatedAt": "2026-08-24T04:15:22.900Z"
}
]{
"code": "ValidationError",
"message": "Query parameters failed validation",
"requestId": "0f1c9f2e-4b8a-4c1e-9d33-2a7f5b1c8e90",
"errors": {
"partySize": [
"partySize must be at least 1"
],
"endDate": [
"endDate must be on or after startDate"
]
}
}{
"code": "NotFoundError",
"message": "Venue not found: 6247",
"requestId": "0f1c9f2e-4b8a-4c1e-9d33-2a7f5b1c8e90"
}{
"code": "InternalError",
"message": "Internal server error",
"requestId": "0f1c9f2e-4b8a-4c1e-9d33-2a7f5b1c8e90"
}id you already hold, use Get a Reservation instead.Authorizations
Your API key. See Authorization to create one.
Path Parameters
The venue being addressed. Every endpoint on this API is venue-scoped.
1"6247"
Query Parameters
First calendar date in the range, inclusive. A bare calendar date — a time component is not accepted.
"2026-09-01"
Last calendar date in the range, inclusive. Defaults to startDate. At most 14 days from startDate, counting both ends.
"2026-09-07"
Response
The venue's reservations in the range.
The identifier that addresses this reservation.
"booking_2026-08-24_G3F7PA8HO438Z_1787294227662"
Venue-local wall clock, ISO formatted. Not an absolute instant.
"2026-08-24T14:00:00"
2
The tables allocated. Empty only for a standby or waitlist entry.
Booking options the guest chose, with the prices that determined what was payable.
Show child attributes
Show child attributes
Where the reservation stands on payment. Always present, including for reservations that take no payment.
Show child attributes
Show child attributes
The reference you quote to a guest. A different identifier from id, and not usable as a path parameter.
"94227662"
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.
U, P$, C, X, NS, S, F, SP, TX 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.
"status_seated_main"
A standby or waitlist entry is the same kind of record as a confirmed booking.
Booking, WaitList, StandbyList 120
Show child attributes
Show child attributes
Guest details recorded on the reservation.
Show child attributes
Show child attributes
The section the reservation asked for, which is often not where the allocated table sits. Absent when no preference was given.
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.
"booking_2026-08-24_G3F7PA8HO438Z_1787294227662"
Originating channel. Read-only — set from your credential when the reservation is created.
"online"
When the reservation was made. An absolute instant, unlike bookingDateTime.