GET /widget/{token}/slots — Bookable Time Slots

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

string

required

The public token for the restaurant.

Query parameters

string

required

The date to fetch slots for, in YYYY-MM-DD format. For example, 2025-05-15.

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

string

required

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

number

required

The party size that was queried, echoed back.

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 slot properties

string

required

The start time of the slot in HH:MM format (24-hour clock). For example, "12:30".

string

required

The name of the service period this slot belongs to — for example, "Lunch" or "Dinner". Useful for grouping slots visually if the restaurant runs multiple services per day.

number

required

The duration of the reservation in minutes. For example, 90 means the table is held for 90 minutes.

boolean

required

true if this slot has enough remaining capacity for the requested party size. false if the slot is fully booked or does not have enough seats.

number

required

The number of additional guests this slot can still accommodate. A value of 0 means the slot is fully booked.

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
    }
  ]
}

Overview

Widget API

Restaurant API

GET /widget/{token}/slots — Bookable Time Slots

Endpoint

Path parameters

Query parameters

Response fields

Example

​Endpoint

​Path parameters

​Query parameters

​Response fields

​Example

Endpoint

Path parameters

Query parameters

Response fields

Example