Gaplessly Hospitality engine API

Read a venue's tables, service periods and reservations, and book, change or cancel reservations, with an API key. A key from an appointments organization gets `403 wrong_vertical`.

GitHub OpenAPI

Operations 10

GET /api/v1/reservations List reservations #
POST /api/v1/reservations Book a table #
GET /api/v1/tables List tables #
PATCH /api/v1/reservations/{id} Change a reservation #
POST /api/v1/reservations/{id}/cancel Cancel a reservation #
POST /api/v1/reservations/{id}/status Seat, finish or no-show a reservation (API key, POS) #
POST /api/v1/reservations/{id}/table Move a party to another table (API key, POS) #
GET /api/v1/reservations/{id}/checks List a reservation's POS checks #
POST /api/v1/reservations/{id}/checks Record what a party spent (API key, POS) #
GET /api/v1/service-periods List service periods #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/gaplessly-com:gaplessly-com-hospitality-engine-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

gaplessly-com-hospitality-engine-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Gaplessly booking Hospitality engine API
  version: 1.0.0
  summary: Two booking engines sharing plumbing, never booking logic.
  description: 'Gaplessly runs **two booking engines**: appointments (a client books one service with one staff member for a set duration) and table reservations (a guest books a table for a party inside a service period). They are two products, not one product with a flag. Each organization runs exactly one, chosen when it signs up, and `businessType` on `GET /api/v1/organization` says which.


    This document covers the surfaces built for other software:


    - **`/api/v1/*`**: an organization''s own data with an API key, sent as `Authorization: Bearer sk_live_…`: read it, find free times, and book, change or cancel on a guest''s behalf. Scoped and rate limited.

    - **`/api/book/{slug}/*`**: the public booking endpoints a business''s booking page calls. No authentication.

    - **`/api/book/{slug}/manage/{token}`**: guest self-service. The token in the guest''s booking link is the whole credential.

    - **`/api/mcp`**: a Model Context Protocol endpoint for AI assistants helping a guest find a time. No authentication.


    Guides, a quickstart and the versioning and deprecation policy: /docs.'
  contact:
    name: Gaplessly
    url: mailto:support@gaplessly.com
servers:
- url: https://gaplessly.com
  description: 'Production. There is deliberately no CORS policy: an API key is a secret, so call `/api/v1` from a server, never from browser JavaScript.'
tags:


# --- truncated at 32 KB (162 KB total) ---
# Full source: https://artifacts.apis.io/gaplessly-com/openapi/gaplessly-com-hospitality-engine-api-openapi.yml