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 surface - the API you use to manage your own venues, bookings, events and vouchers. Other parts of the Sidedoor platform are internal and not part of this public API.

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

Log in to obtain a session bearer token, then send it 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.

Handle payments

Sidedoor operates the Stripe webhook that fulfils checkout - you receive payouts via Stripe Connect.

Reference & guides

AuthenticationObtain a session bearer token and send Authorization: Bearer.

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

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

WebhooksThe platform-managed Stripe webhook that fulfils payments.

API tokens (planned)The proposed sk_ API-token programme - not yet available.

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.