Developers

OpenALaCarte API

A REST API to read your bookings, orders, and menus, create bookings server-to-server, and receive signed webhook events in real time. JSON over HTTPS, Bearer-key auth, cursor pagination, ISO-8601 UTC timestamps.

Base URL

https://openalacarte.com/api/v1

OpenAPI spec Get an API key

Bearer keys

Company-scoped keys, shown once at creation.

60 req/min

Per key, with standard rate-limit headers.

Signed webhooks

HMAC-SHA256, at-least-once, with retries.

Quickstart

Mint a key in API keys, then list your bookings:

cURL

curl https://openalacarte.com/api/v1/bookings \
  -H "Authorization: Bearer oac_live_<your-key>"

JavaScript (fetch)

const res = await fetch("https://openalacarte.com/api/v1/bookings?limit=50", {
  headers: { Authorization: `Bearer ${process.env.OAC_API_KEY}` },
});
const { data, nextCursor } = await res.json();

Reference

Authentication & conventions

API keys, rate limits, errors, pagination, versioning.

Bookings

List and create bookings across your restaurants.

Orders

Read orders, advance status, issue refunds.

Menu items

Sync your full menu to a POS or aggregator.

Webhooks

Signed, real-time events with retries.

Website & operations

Enquiries

Read and update website contact-form submissions.

Newsletter

List, add and unsubscribe newsletter subscribers.

Reviews

List diner reviews across your restaurants.

Site analytics

Tenant-website traffic: views, top pages, daily series.

Customers

A CRM roll-up of diners built from bookings.

Live (front-of-house)

Today's bookings, covers and next arrivals.

Calendar feed

iCalendar feed of upcoming bookings.

AI-drafted replies to reviews.

Vouchers

Issue, redeem and void operator vouchers. Write endpoints need a company key.

Menu availability

Mark items sold out (86-ing) and set stock.

Availability

Check whether a booking slot can seat a party.

Reports

Revenue, orders and covers per restaurant.

Site pages (headless CMS)

Read, edit and publish your website's pages as raw HTML.

Memberships

Members of your regulars / loyalty plans.

Promo codes

List and create discount codes.

Waitlist

Booking waitlist entries across your restaurants.

Tables & QR

Floor-plan tables with their scan-to-order QR links.