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.

Creating a reservation through the Widget API is a two-step process. First, you lock the desired slot to hold it temporarily. Then, you confirm the reservation by submitting the guest’s contact details. This two-step flow prevents double-bookings when multiple guests are viewing the same time slot simultaneously.
The lock token returned in step 1 expires quickly. You must complete step 2 before it expires — if it does, the slot is released and you must call the lock endpoint again to reserve a new slot.
1

Lock a slot

Send a POST request to reserve a specific date, time, and party size. The API temporarily holds that slot and returns a lock_token.

​
Endpoint

POST https://api.lakreme.fr/api/v1/widget/{publicToken}/reservations/lock
No authentication is required.

​
Path parameters

​
publicToken
string
required
The public token for the restaurant.

​
Request body

​
date
string
required
The reservation date in YYYY-MM-DD format.
​
time
string
required
The start time of the slot in HH:MM format (24-hour clock).
​
guests
number
required
The number of guests in the party.
​
lang
string
default:"fr"
Language for the confirmation message returned in step 2. Accepted values: fr, en.

​
Response fields

​
lock_token
string
required
A short-lived token that identifies the locked slot. Pass this token in step 2 to confirm the reservation.
​
expires_at
string
required
ISO 8601 timestamp indicating when the lock expires. Complete step 2 before this time.
​
table_id
string
required
The ID of the table that was assigned to hold this slot.
curl -X POST "https://api.lakreme.fr/api/v1/widget/tok_abc123/reservations/lock" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2025-05-15",
    "time": "12:30",
    "guests": 2,
    "lang": "en"
  }'

{
  "lock_token": "lck_9f3a2b1c4d5e6789",
  "expires_at": "2025-05-12T14:07:00Z",
  "table_id": "tbl_001"
}
2

Confirm the reservation

Submit the guest’s contact details along with the lock_token from step 1. If the lock is still valid, the reservation is created and a confirmation code is returned.

​
Endpoint

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

​
Path parameters

​
publicToken
string
required
The public token for the restaurant.

​
Request body

​
lock_token
string
required
The lock token returned from step 1. This token must not have expired.
​
guest_first_name
string
required
Guest’s first name.
​
guest_last_name
string
required
Guest’s last name.
​
guest_email
string
required
Guest’s email address. La Krème sends the confirmation email here.
​
guest_phone
string
required
Guest’s phone number.
​
lang
string
default:"fr"
Language for the confirmation email and response message. Accepted values: fr, en.

​
Response fields

​
reservation_id
string
required
Unique identifier for the newly created reservation.
​
confirmation_code
string
required
A short alphanumeric code the guest can use to reference their booking (for example, ABC-1234).
​
status
string
required
Initial status of the reservation. confirmed if the restaurant uses automatic confirmation, or pending if manual confirmation is required.
​
restaurant_name
string
required
Name of the restaurant, included for display in your confirmation UI.
​
date
string
required
The reservation date in YYYY-MM-DD format, echoed back.
​
time
string
required
The reservation time in HH:MM format, echoed back.
​
guests
number
required
The party size, echoed back.
​
message
string
required
A human-readable confirmation message in the requested language, suitable for displaying directly to the guest.
curl -X POST "https://api.lakreme.fr/api/v1/widget/tok_abc123/reservations" \
  -H "Content-Type: application/json" \
  -d '{
    "lock_token": "lck_9f3a2b1c4d5e6789",
    "guest_first_name": "Marie",
    "guest_last_name": "Dupont",
    "guest_email": "[email protected]",
    "guest_phone": "+33 6 98 76 54 32",
    "lang": "en"
  }'

{
  "reservation_id": "res_a1b2c3d4",
  "confirmation_code": "ABC-1234",
  "status": "confirmed",
  "restaurant_name": "Le Petit Bistro",
  "date": "2025-05-15",
  "time": "12:30",
  "guests": 2,
  "message": "Your reservation is confirmed! See you on May 15 at 12:30."
}