AUTH.

Alle API-verzoeken moeten je API-key bevatten in de X-API-KEY HTTP-header.

curl -X GET https://carteblanche.rocks/api/v1/restaurants \ -H "X-API-KEY: your_api_key_here"

WEBHOOKS.

Blijf op de hoogte met directe meldingen. Onze Webhook-engine stuurt gegevens rechtstreeks naar jouw systeem wanneer er een nieuwe reservatie wordt gemaakt of een status verandert.

{ "event": "reservation.created", "timestamp": "2026-05-08T14:30:00Z", "data": { "id": "res_827364", "restaurant": "The Jane", "covers": 2 } }

ENDPOINTS

GET /api/v1/restaurants

Uitsluitend restaurants uit de huidige Michelin- of Gault&Millau-gids.

[ { "name": "The Jane", "slug": "the-jane", "city": "Antwerp", "stars": 2 }, ... ]
GET /api/v1/availability

Realtime aanbod van onze sterrenchefs. Kleine borg van {price} tegen no-shows.

[ { "slug": "the-jane", "date": "2026-05-08", "items": [ { "id": "three-course", "capacity": 4, "time": "19:30" } ] }, ... ]
POST /api/v1/availability

Push beschikbaarheid rechtstreeks vanuit je POS- of voorraadsysteem.

{ "slug": "the-jane", "date": "2026-05-15", "items": [ { "id": "three-course", "capacity": 8, "time": "19:30" } ] }
POST /api/v1/webhooks

Registreer een URL om realtime meldingen voor je restaurant te ontvangen.

{ "slug": "the-jane", "url": "https://your-system.com/webhooks/cb" }
GET /api/v1/reservations/{id}

Haal de huidige status van een reservatie op.

POST /api/v1/reservations

Maak een reservatie aan vanuit een extern systeem. Gasten worden geïdentificeerd via e-mail.

{ "slug": "the-jane", "date": "2026-05-15", "combi": "three-course", "email": "guest@carteblanche.rocks", "name": "John Doe", "persons": 2, "phone": "+32...", "notes": "Window seat please" }
PUT /api/v1/reservations/{id}

Werk een bestaande reservatie bij (bv. couverts of datum wijzigen).

{ "persons": 4, "notes": "Updated: now 4 people" }
DELETE /api/v1/reservations/{id}

Annuleer een reservatie. Dit geeft de couverts vrij.