Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.koulis.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
publicToken
string
required
The public token for the restaurant.

​
Query parameters

​
month
string
required
The month to check, in YYYY-MM format. For example, 2025-05 for May 2025.
​
guests
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

​
month
string
required
The month that was queried, echoed back in YYYY-MM format.
​
guests
number
required
The party size that was queried, echoed back.
​
dates
object[]
required
Array of date availability objects, one per calendar day in the requested month.
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 }
  ]
}