Sidedoor operator API

The Sidedoor operator/venue REST API is a JSON REST API. Every endpoint lives under /api/* at https://thesidedoor.co, speaks JSON in and out, and is scoped to the venues your operator account can access.

Use it to build on behalf of a venue operator: manage bookings and the live reservation floor, read availability, run events, sell and redeem vouchers, look after guests, configure branding, and power booking widgets you embed on your own site.

Operator API

These docs cover the operator/venue API - the endpoints you use to manage your own venues, bookings, events, availability and vouchers.

What you can build

• Bookings & reservations - create, approve, reject and check in bookings; drive the table floor; capture or release card-hold deposits.
• Availability - read open slots, floorplans and booking windows for a date and party size.
• Events - publish events, manage ticket types and handle event bookings.
• Vouchers - configure gift vouchers, issue comps and redeem codes.
• Guests - read your guest roster, activity and tags.
• Embeddable widgets - the public widget endpoints that let a guest book a table, buy a ticket or a voucher without leaving your website.

Start here

Authenticate

Create a scoped API token, then send it as a bearer header on every request. See Authentication.

Learn the conventions

Base URL, JSON shapes, errors, pagination, caching and rate limits - the rules that apply to every endpoint. See Conventions.

Browse the reference

Every resource, endpoint by endpoint, with worked examples. Start at the API reference.

Create an API token

Mint a scoped, revocable token for unattended server-to-server calls - no interactive login. See API tokens.

Reference & guides

AuthenticationCreate an API token and send Authorization: Bearer on every request.

ConventionsBase URL, JSON, errors, pagination, ETags, caching and rate limits.

API referenceEvery operator resource, organised by area with a language switcher.

API tokensCreate a scoped, revocable sk_ API token for server-to-server calls.

The language switcher

Every worked example on this site is shown in cURL, JavaScript and PHP. Pick a language once with the tab at the top of any example and the whole site follows your choice. Examples use the environment variable SIDEDOOR_TOKEN for your bearer token and placeholders like VENUE_ID and BOOKING_ID.