Skip to content
Barestho Partnership

Retrieve restaurant availabilities

GET
/api/v1/partnership/restaurants/{id}/availabilities/
 
curl --request GET \
  --url 'https://public.api.barestho.com/api/v1/partnership/restaurants/example/availabilities/?from_datetime=example&to_datetime=example' \
  --header 'Authorization: Basic <credentials>'

Returns the booking availability slots for the given restaurant. Partners should query this endpoint before creating a reservation to ensure the desired time slot is open. The response follows the same shape as PartnerRestaurant and may include time-slot metadata depending on the restaurant’s configuration.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

The unique identifier of the restaurant whose availabilities are requested.

Query Parameters

Section titled “Query Parameters ”
from_datetime
required
string

The date and time from which availabilities will be calculated.

to_datetime
required
string

The date and time to which availabilities will be calculated.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Availability information for the specified restaurant.

Media type application/json

Represents a restaurant that is accessible to the authenticated partner. All fields except schema_name are read-only and managed by the restaurant owner on the Barestho platform.

object
id

Unique numeric identifier for the restaurant, assigned by the server.

integer
display_name

Human-readable name of the restaurant as configured by its owner.

string
schema_name
required

Internal tenant identifier used to scope database queries. This value is assigned during restaurant onboarding and must be unique across the platform. Maximum length is 63 characters.

string
<= 63 characters
address

Full postal address of the restaurant.

string
website

URL of the restaurant’s public website, if provided.

string
latitude

Geographic latitude of the restaurant location (WGS 84 decimal degrees).

number format: float
longitude

Geographic longitude of the restaurant location (WGS 84 decimal degrees).

number format: float
timezone

IANA timezone identifier for the restaurant (e.g. Europe/Paris). All reservation start_time values should be interpreted in this timezone.

string
Example generated
{
  "schema_name": "example"
}