Create or Update Reservation
Create a new reservation or provide updates about guests, deposits, status, etc.
Path parameters
-
The unique code assigned to the reservation platform.
Maximum length is
11
. Format should match the following pattern:[a-zA-Z0-9_-]+
. -
The external platform's unique identifier for the restaurant.
Format should match the following pattern:
[a-zA-Z0-9_-]+
. -
The external identifier of the reservation.
Maximum length is
36
. Format should match the following pattern:[a-zA-Z0-9_-]+
.
Body
Required
-
Guest information associated with the reservation.
-
The guest's obligation for the reservation.
-
Venue-entered notes specific to the reservation.
-
Any special offer linked to the reservation.
-
The number of expected guests.
-
An optional sequence number assigned by the external platform. If provided, it will be used to determine the order of updates of a reservation. It is the responsibility of the external platform to provide a monotonically increasing sequence number. If omitted, the utcUpdatedAt field will be used to determine the order of updates. That can be imprecise when dealing with events that happen in short timeframes in a distributed system. The value SHOULD NOT be set to null or zero or any special value, but instead omitted from the JSON object entirely if it is not used.
-
External reservation statuses for platforms.
Values are
ON_HOLD
,SCHEDULED
,PARTIALLY_ARRIVED
,ARRIVED
,PARTIALLY_SEATED
,SEATED
,DEPARTED
,CANCELLED
,NO_SHOW
, orERROR
. -
The list of table numbers associated with this reservation. If no valid table is provided, POS order is not created.
-
The scheduled reservation time.
-
The timestamp of the most recent change to the reservation.
curl \
--request PUT 'https://api.trial.lsk.lightspeed.app/reservation/api/1/platform/MyPlatform/restaurant/Restaurant-123/reservation/Reservation-123/push' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"guest":{"email":"john.smith@email.com","firstName":"John","lastName":"Smith","phone":"+13453455555","platformGuestId":"ABC-123","walkIn":true,"foodAndDrinkNotes":"Only milk and cookies!","notes":"Put the ring in the champagne!","language":"en","allergens":["almonds","egg"],"dietaryRestrictions":["no alcohol","vegan"]},"liability":{"currency":"EUR","deposits":[{"amount":"100.00","platformDepositId":"1","utcCreatedAt":"2024-01-01T20:00:00","utcVoidedAt":"2024-01-01T20:00:00","voided":false}],"refunds":[{"amount":"100.00","platformRefundId":"1","utcCreatedAt":"2024-01-01T20:00:00","utcVoidedAt":"2024-01-01T20:00:00","voided":false}]},"notes":"More balloons!","specialOffer":"Free dessert","tags":["romantic meal","special occasion"],"partySize":2,"sequenceId":145789499819,"status":"SCHEDULED","tableNumbers":["1"],"utcScheduledAt":"2024-01-01T20:00:00","utcUpdatedAt":"2024-01-01T20:10:00"}'
{
"guest": {
"email": "john.smith@email.com",
"firstName": "John",
"lastName": "Smith",
"phone": "+13453455555",
"platformGuestId": "ABC-123",
"walkIn": true,
"foodAndDrinkNotes": "Only milk and cookies!",
"notes": "Put the ring in the champagne!",
"language": "en",
"allergens": [
"almonds",
"egg"
],
"dietaryRestrictions": [
"no alcohol",
"vegan"
]
},
"liability": {
"currency": "EUR",
"deposits": [
{
"amount": "100.00",
"platformDepositId": "1",
"utcCreatedAt": "2024-01-01T20:00:00",
"utcVoidedAt": "2024-01-01T20:00:00",
"voided": false
}
],
"refunds": [
{
"amount": "100.00",
"platformRefundId": "1",
"utcCreatedAt": "2024-01-01T20:00:00",
"utcVoidedAt": "2024-01-01T20:00:00",
"voided": false
}
]
},
"notes": "More balloons!",
"specialOffer": "Free dessert",
"tags": [
"romantic meal",
"special occasion"
],
"partySize": 2,
"sequenceId": 145789499819,
"status": "SCHEDULED",
"tableNumbers": [
"1"
],
"utcScheduledAt": "2024-01-01T20:00:00",
"utcUpdatedAt": "2024-01-01T20:10:00"
}
{
"platformCode": "MyPlatform",
"platformRestaurantId": "Restaurant-123",
"platformReservationId": "Reservation-123",
"accepted": true
}