Skip to content

Same time at sister venues

GET
/api/book/{slug}/siblings

When the time a guest wanted is gone, the booking page's alternatives panel asks this for the SAME organization's other table-reservation venues that have a table at that exact time for that party. Answers an empty list unless the organization switched sister-venue suggestions on in its business settings (off by default).

Each candidate is checked through GET .../reservations/availability itself, called in process, so a venue listed here is one whose own checkout will accept that sitting. Only active venues, never an API sandbox, never one whose online booking is paused by the booking meter. At most six are checked (name order) and three listed. Each entry carries the venue's name, slug, the time and a link to its booking page with date, time and party_size prefilled; nothing else about a sister venue is returned.

Rate limited on the guest read budget before the slug is resolved; each candidate check spends one more unit of it. Uncached, like availability.

Path Parameters

slug*string

The organization's public booking slug, i.e. the {slug} in /{slug}. Only orgs with status active resolve; anything else is a 404.

Query Parameters

date*string

YYYY-MM-DD, a real calendar date.

Formatdate
time*string

HH:MM on the venues' wall clock.

Match^([01]\d|2[0-3]):[0-5]\d$
party*integer

Party size.

Range1 <= value <= 30

Response Body

application/json

application/json

curl -X GET "https://example.com/api/book/string/siblings?date=2019-08-24&time=string&party=1"
{  "venues": [    {      "name": "string",      "slug": "string",      "time": "string",      "url": "string"    }  ]}