Skip to main content
The La Krème REST API gives you programmatic access to your restaurant’s reservation system. There are two distinct API surfaces: the Widget API, which is public and lets you build custom booking flows for your guests, and the Restaurant API, which requires authentication and gives you full control over your configuration, tables, opening hours, and reservations. All requests and responses use JSON. The base URL for every endpoint is:

​
The two API surfaces

Widget API

Public endpoints — no authentication required. Use your publicToken in the URL path to access availability calendars, time slots, and the two-step reservation flow. Designed for custom booking UIs.

Restaurant API

Authenticated endpoints — requires a JWT Bearer token. Use these to read and update your restaurant configuration, manage tables and opening hours, and view or create reservations from the operator side.

​
Authentication

The Widget API uses your public token in the URL path — no secret credentials required. The Restaurant API requires a JWT Bearer token obtained after logging in through La Krème. See Authentication for how to obtain and pass your token.

​
Responses

All responses are JSON objects. Successful requests return one of the following HTTP status codes:

​
Errors

When a request fails, the API returns an error object with a human-readable message in the detail or message field. Always check the HTTP status code alongside the message.
Common error status codes:

Authentication

How to obtain and pass your JWT token for Restaurant API calls.

Widget config

Fetch restaurant branding, rules, and settings for your custom booking UI.

Restaurant config

Read and update your widget configuration and booking rules via the API.