Skip to navigation
API referenceReservations

List available reservation times

Returns the reservation times for one date and party size, in 15-minute slots. available: true means at least one table, or combination of tables, that can be booked online fits the party at that time.

Slots are left out when they are outside opening hours, too late in the day (after closing time minus the restaurant’s service time), inside the restaurant’s minimum notice, or after the restaurant has closed online booking for that day. A party larger than maxPartySize gets an empty list.

If the restaurant does not take table reservations, the response is { "enabled": false, "slots": [] }.

Rate limit: 60 requests per 60 seconds per slug and IP. Cached at the edge for 15 seconds (plus 30 s stale-while-revalidate). Walkthrough: Table reservations.

Authentication

AuthorizationBearer

Either this or a trusted browser origin. The restaurant’s API key, sent as Authorization: Bearer lbs_…. Use it from your server only, never in browser code. Keys are issued per restaurant by LettBestilt.

OR
Originstring

Either this or an API key. No key is needed when the request’s Origin header is trusted for this restaurant: https://{slug}.lettbestilt.no, a verified domain of the restaurant, or a partner origin LettBestilt has bound to the restaurant. Browsers set Origin themselves; it is not something you configure. Not accepted by GET /site-gate, which requires an API key.

Query parameters

slugstringRequired
The restaurant's slug.
datestringRequiredformat: "^\d{4}-\d{2}-\d{2}$"

The date as YYYY-MM-DD, in Oslo time.

partySizeintegerOptional1-50Defaults to 2
Number of guests. Defaults to 2.

Response

The slots for the date.
enabledbooleanOptional
Whether the restaurant takes table reservations.
maxPartySizeintegerOptional

The largest party that can book online. Only present when enabled is true.

slotslist of objectsOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error