List a venue's sales
curl --request GET \
--url https://platform.uat.nowbookit.com/api/sales/transactions \
--header 'Authorization: Bearer <token>'import requests
url = "https://platform.uat.nowbookit.com/api/sales/transactions"
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/sales/transactions', 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/sales/transactions",
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/sales/transactions"
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/sales/transactions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.uat.nowbookit.com/api/sales/transactions")
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{
"sales": [
{
"venueId": "<string>",
"orgId": "<string>",
"saleId": "<string>",
"partnerSaleId": "<string>",
"partnerId": "<string>",
"source": "<string>",
"transactionType": "Sale",
"recordType": "Final",
"reconciliationStatus": "Unmatched",
"bookingId": "<string>",
"openedAt": "2023-11-07T05:31:56Z",
"dinerId": "<string>",
"dinerResolved": true,
"total": 123,
"currency": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"partnerName": "<string>",
"posStatus": "<string>",
"posLocationId": "<string>",
"posLocationName": "<string>",
"originalSaleId": "<string>",
"originalSaleResolved": true,
"venueName": "<string>",
"timeZoneId": "<string>",
"serviceId": "<string>",
"serviceName": "<string>",
"tables": [
{
"name": "<string>",
"seats": 123,
"sectionId": "<string>",
"sectionName": "<string>"
}
],
"covers": 123,
"closedAt": "2023-11-07T05:31:56Z",
"register": {},
"staffId": "<string>",
"staffName": "<string>",
"diner": {},
"items": [
{
"id": "<string>",
"name": "<string>",
"quantity": 123,
"unitPrice": 123,
"total": 123,
"sku": "<string>",
"category": "<string>",
"barcode": "<string>",
"unitTax": 123,
"discount": 123
}
],
"payments": [
{
"id": "<string>",
"type": "CASH",
"amount": 123,
"status": "<string>",
"tip": 123,
"surcharge": 123,
"terminalId": "<string>",
"transactionReference": "<string>"
}
],
"subtotal": 123,
"tax": 123,
"discount": 123,
"surcharges": 123,
"tip": 123
}
],
"nextCursor": "<string>"
}{
"code": "ValidationError",
"message": "Query parameters failed validation",
"requestId": "c47a9e21-8b3d-4f6a-9e12-example",
"errors": {
"query": [
"endDate must not be before startDate"
]
}
}{
"code": "UnauthorisedError",
"message": "Invalid API key",
"requestId": "8f14e45f-ceea-4c6f-8f89-example"
}{
"code": "AppError",
"message": "iPOS API-key resolve endpoint returned an unexpected response",
"requestId": "6e2a9c4f-1d3b-4a7e-9c5f-example"
}Sales
List Sales
Retrieve a venue’s sales within a date range.
GET
/
api
/
sales
/
transactions
List a venue's sales
curl --request GET \
--url https://platform.uat.nowbookit.com/api/sales/transactions \
--header 'Authorization: Bearer <token>'import requests
url = "https://platform.uat.nowbookit.com/api/sales/transactions"
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/sales/transactions', 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/sales/transactions",
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/sales/transactions"
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/sales/transactions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.uat.nowbookit.com/api/sales/transactions")
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{
"sales": [
{
"venueId": "<string>",
"orgId": "<string>",
"saleId": "<string>",
"partnerSaleId": "<string>",
"partnerId": "<string>",
"source": "<string>",
"transactionType": "Sale",
"recordType": "Final",
"reconciliationStatus": "Unmatched",
"bookingId": "<string>",
"openedAt": "2023-11-07T05:31:56Z",
"dinerId": "<string>",
"dinerResolved": true,
"total": 123,
"currency": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"partnerName": "<string>",
"posStatus": "<string>",
"posLocationId": "<string>",
"posLocationName": "<string>",
"originalSaleId": "<string>",
"originalSaleResolved": true,
"venueName": "<string>",
"timeZoneId": "<string>",
"serviceId": "<string>",
"serviceName": "<string>",
"tables": [
{
"name": "<string>",
"seats": 123,
"sectionId": "<string>",
"sectionName": "<string>"
}
],
"covers": 123,
"closedAt": "2023-11-07T05:31:56Z",
"register": {},
"staffId": "<string>",
"staffName": "<string>",
"diner": {},
"items": [
{
"id": "<string>",
"name": "<string>",
"quantity": 123,
"unitPrice": 123,
"total": 123,
"sku": "<string>",
"category": "<string>",
"barcode": "<string>",
"unitTax": 123,
"discount": 123
}
],
"payments": [
{
"id": "<string>",
"type": "CASH",
"amount": 123,
"status": "<string>",
"tip": 123,
"surcharge": 123,
"terminalId": "<string>",
"transactionReference": "<string>"
}
],
"subtotal": 123,
"tax": 123,
"discount": 123,
"surcharges": 123,
"tip": 123
}
],
"nextCursor": "<string>"
}{
"code": "ValidationError",
"message": "Query parameters failed validation",
"requestId": "c47a9e21-8b3d-4f6a-9e12-example",
"errors": {
"query": [
"endDate must not be before startDate"
]
}
}{
"code": "UnauthorisedError",
"message": "Invalid API key",
"requestId": "8f14e45f-ceea-4c6f-8f89-example"
}{
"code": "AppError",
"message": "iPOS API-key resolve endpoint returned an unexpected response",
"requestId": "6e2a9c4f-1d3b-4a7e-9c5f-example"
}Retrieves your venue’s sales within a date range, oldest first. Results are always scoped to the venue tied to your API key — there’s no way to list sales for another venue.
Large ranges are paginated. When a response includes a
nextCursor, pass it back as the cursor parameter to fetch the next page; nextCursor is null once you’ve reached the end.reconciliationStatus reflects whether the sale was matched to a booking: Matched (found, and enriched with service/table/diner details), Unmatched (a match was attempted but nothing found), or PendingMatch (matching couldn’t be completed and may resolve later).recordType is Final (closed/settled), Incremental (accumulates onto the stored record on resend), or Tally (a running snapshot of a still-open sale — resends are diffed against the stored record and only changed fields are applied). See Ingest Sale for details on resend behavior per type.Example
curl --location 'https://platform.uat.nowbookit.com/api/sales/transactions?startDate=2026-07-23T00:00:00Z&endDate=2026-07-24T00:00:00Z&limit=50' \
--header 'Authorization: Bearer your_api_key_here'
Response — 200 OK
{
"sales": [
{
"saleId": "01J...ULID",
"partnerSaleId": "pos-sale-9981",
"transactionType": "Sale",
"recordType": "Final",
"reconciliationStatus": "Matched",
"bookingId": "abc-123",
"openedAt": "2026-07-23T19:05:00.000Z",
"closedAt": "2026-07-23T20:45:00.000Z",
"tables": [{ "name": "12", "seats": 4 }],
"staffId": "staff-7",
"items": [
{
"id": "item-1",
"name": "Wagyu Steak",
"quantity": 2,
"unitPrice": 6500,
"total": 13000
}
],
"payments": [{ "id": "pay-1", "type": "EFTPOS", "amount": 18500 }],
"total": 18500,
"currency": "AUD"
}
],
"nextCursor": null
}
Authorizations
Your API key. See Authorization to create one.
Query Parameters
Any UTC offset accepted; normalised to UTC.
Must not be before startDate.
Opaque pagination cursor from a previous response's nextCursor.
How many sales to return at once (1–200). Defaults to 50.
Required range:
1 <= x <= 200