📃 Managing Reservations

Access Scope

A partner only has access to reservations they have personally created via the API. Reservations originating from other channels (Barestho form, Google, etc.) are not visible.

List and Create Reservations

Reservations for a restaurant are accessible via:

https://public.api.barestho.com/api/v1/partnership/restaurants/:restaurant_id/reservations/

List Reservations

GET /api/v1/partnership/restaurants/:restaurant_id/reservations/ HTTP/1.1
Host: public.api.barestho.com
Authorization: Basic <base64(uuid:token)>

Create a Reservation

POST /api/v1/partnership/restaurants/:restaurant_id/reservations/ HTTP/1.1
Host: public.api.barestho.com
Authorization: Basic <base64(uuid:token)>
Content-Type: application/json

{
  "id": 25,
  "first_name": "Kristopher",
  "last_name": "Weissnat",
  "email": null,
  "phone": null,
  "start_time": "2026-05-12T12:00:00+02:00",
  "duration": "02:00:00",
  "adults": 3,
  "children": 0,
  "comment": null,
  "cancelled": false,
  "cancelled_at": null,
  "confirmed": false,
  "confirmed_at": null,
  "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS",
  "arrived": false,
  "arrived_at": null,
  "no_show": false,
  "no_show_at": null,
  "language": "en",
  "metadata": null
}

Cancel a Reservation

A partner can only cancel reservations they have created:

PATCH /api/v1/partnership/restaurants/:restaurant_id/reservations/:id/?action=cancel HTTP/1.1
Host: public.api.barestho.com
Authorization: Basic <base64(uuid:token)>

Webhook Events

The following events can be received on your webhooks regarding your reservations:

Event	Trigger
`RESERVATION_CONFIRMED`	The restaurant has manually confirmed the reservation
`RESERVATION_MODIFIED`	The reservation has been modified by the restaurant or the customer
`RESERVATION_CANCELLED`	The reservation has been cancelled by the partner, the restaurant, or the customer