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 slots endpoint returns all time slots for a given date, including which slots still have capacity for the requested party size. Use this after the guest picks a date from the availability calendar to show them the exact times they can book.

​
Endpoint

GET https://api.lakreme.fr/api/v1/widget/{publicToken}/slots
No authentication is required.

​
Path parameters

​
publicToken
string
required
The public token for the restaurant.

​
Query parameters

​
date
string
required
The date to fetch slots for, in YYYY-MM-DD format. For example, 2025-05-15.
​
guests
number
required
The number of guests in the party. Slots where remaining_capacity is less than this value will be returned with available: false.

​
Response fields

​
date
string
required
The date that was queried, echoed back in YYYY-MM-DD format.
​
guests
number
required
The party size that was queried, echoed back.
​
slots
object[]
required
Array of time slot objects for the requested date. Includes both available and unavailable slots so you can show a complete schedule with greyed-out times.
Show all slots in the response — even those with available: false — so guests can see the full schedule. Displaying unavailable slots as greyed-out gives a clearer picture of the restaurant’s rhythm than hiding them entirely.

​
Example

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

{
  "date": "2025-05-15",
  "guests": 2,
  "slots": [
    {
      "time": "12:00",
      "service_name": "Lunch",
      "duration_min": 90,
      "available": true,
      "remaining_capacity": 10
    },
    {
      "time": "12:30",
      "service_name": "Lunch",
      "duration_min": 90,
      "available": true,
      "remaining_capacity": 6
    },
    {
      "time": "13:00",
      "service_name": "Lunch",
      "duration_min": 90,
      "available": false,
      "remaining_capacity": 0
    },
    {
      "time": "19:30",
      "service_name": "Dinner",
      "duration_min": 120,
      "available": true,
      "remaining_capacity": 14
    },
    {
      "time": "20:00",
      "service_name": "Dinner",
      "duration_min": 120,
      "available": true,
      "remaining_capacity": 8
    }
  ]
}