GET /widget/{token}/availability — Monthly Calendar

The availability endpoint returns a list of every date in a given month and whether each date has at least one bookable slot for the requested party size. Use this to power your booking calendar: highlight available dates in green and grey out unavailable ones before the guest picks a day.

Endpoint

GET https://api.lakreme.fr/api/v1/widget/{publicToken}/availability

No authentication is required.

Path parameters

string

required

The public token for the restaurant.

Query parameters

string

required

The month to check, in YYYY-MM format. For example, 2025-05 for May 2025.

number

required

The number of guests in the party. A date is only marked available: true if there is at least one open slot with enough remaining capacity for this party size.

Response fields

string

required

The month that was queried, echoed back in YYYY-MM format.

number

required

The party size that was queried, echoed back.

object[]

required

Array of date availability objects, one per calendar day in the requested month.

Show dates properties

string

required

The calendar date in YYYY-MM-DD format.

boolean

required

true if the restaurant has at least one open time slot for the given party size on this date. false if the date is fully booked, falls outside the advance_booking_days window, or has no active service.

A date is marked available: true only when there is at least one slot with remaining_capacity greater than or equal to the requested guests value. Use GET Time Slots to fetch the individual slots for a specific date.

Example

curl "https://api.lakreme.fr/api/v1/widget/tok_abc123/availability?month=2025-05&guests=2"

{
  "month": "2025-05",
  "guests": 2,
  "dates": [
    { "date": "2025-05-01", "available": false },
    { "date": "2025-05-02", "available": true },
    { "date": "2025-05-03", "available": true },
    { "date": "2025-05-04", "available": false },
    { "date": "2025-05-05", "available": true },
    { "date": "2025-05-06", "available": true },
    { "date": "2025-05-07", "available": true },
    { "date": "2025-05-08", "available": false },
    { "date": "2025-05-09", "available": false }
  ]
}

Overview

Widget API

Restaurant API

GET /widget/{token}/availability — Monthly Calendar

Endpoint

Path parameters

Query parameters

Response fields

Example

​Endpoint

​Path parameters

​Query parameters

​Response fields

​Example

Endpoint

Path parameters

Query parameters

Response fields

Example