Quandoo is a restaurant reservations marketplace that connects diners with thousands of restaurants and gives merchants table, reservation, and reputation management tooling. Quandoo publishes the Public Partner API, a multi-purpose REST API (host public-api.prod.quandoo.com, authenticated with the X-Quandoo-AuthToken header) that lets partners check merchant availability, search merchants, read merchant reservation and enquiry settings, create and manage reservations and reservation enquiries, manage customers and reviews, handle reservation tags, and validate phone numbers. Reservation and enquiry creation is idempotent via agent-supplied unique identifiers, and returns HTTP 409 when a slot is no longer bookable. Quandoo offers widget, portal, discovery-widget, and direct integration paths plus an interactive API explorer. Note: Quandoo announced in March 2026 that it will wind down operations, with new bookings ending 30 September 2026; this profile documents the still-live Public Partner API as published.
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Restaurant, Reservations, Booking, Availability, Merchants, Marketplace
- Created: 2026-06-02
- Modified: 2026-06-03
The Quandoo Public Partner API is a multi-purpose REST API for the Quandoo platform. It lets partners check merchant availability, create reservations and reservation enquiries, read merchant reservation settings, and manage table planning. Reservation creation is idempotent using an agent-specific unique ID. An interactive API explorer is provided for testing endpoints and parameters.
Human URL: https://docs.quandoo.com/
Base URL: https://public-api.prod.quandoo.com
- Reservations, Availability, Merchants, Booking
- Documentation
- GettingStarted
- OpenAPI
- APIReference
- Authentication
- 59 JSONSchema artifacts
- 59 JSONStructure artifacts
- 59 Example artifacts
- 10 NaftikoCapability artifacts
- Website
- Documentation
- APIReference
- Support
- GitHubOrganization
- SpectralRules
- Vocabulary
- JSON-LD
- Plans
- RateLimits
- FinOps
- Pricing
- TermsOfService
| Name | Description |
|---|---|
| Availability Search | Check merchant availability days and time slots and search bookable merchants by place, location, date, time, and capacity. |
| Reservation Management | Create, retrieve, and update reservations with idempotent creation keyed on an agent-specific unique ID. |
| Reservation Enquiries | Create and manage reservation enquiries (for larger groups) including reading enquiry messages and updating status. |
| Merchant Settings | Read merchant reservation and enquiry settings such as capacities, areas, online reservation interval, and credit-card-vault requirements. |
| Reviews | Read, create, and update customer reviews tied to reservations. |
| Phone Validation | Validate customer phone numbers before submitting a reservation. |
| Multiple Integration Paths | Widget, portal, discovery-widget, and direct integration options plus an interactive API explorer. |
| Name | Description |
|---|---|
| Embedded Booking Experiences | Build diner-facing booking flows that search merchants, check availability, and create reservations on top of Quandoo inventory. |
| Group Enquiry Handling | Route large-party requests to the enquiry workflow when group size exceeds the merchant minimum for enquiries. |
| Merchant Operations | Let restaurant operators manage reservations, customers, tags, and reviews for their venue. |
| Channel Attribution | Distinguish marketplace covers from free own-channel covers (widget, Google, social) for cost attribution. |
| Name | Description |
|---|---|
| Booking Widget | Embeddable Quandoo booking widget for merchant websites and apps. |
| Google Network | Reservations sourced through the Google network. |
| Social Media | Booking integrations across social media channels. |
| Discovery Widget | Restaurant discovery widget for surfacing bookable merchants. |
Machine-readable API specifications organized by format.
- Quandoo Public Partner API — 24 operations, 60 schemas, derived from the official Quandoo Swagger (api.quandoo.com/swagger.json)
- 59 schema files in json-schema/, one per OpenAPI component schema.
- 59 structure files in json-structure/, converted from the JSON Schema set.
- Quandoo Context — linked-data context with 176 property terms and schema.org alignments.
- 59 example payloads in examples/, one per schema.
Naftiko capabilities organized as self-contained per-surface definitions, each exposing both a REST and an MCP adapter.
| Capability | Operations | MCP Tools |
|---|---|---|
| Status | 1 | 1 |
| Customers | 3 | 3 |
| Merchants | 5 | 5 |
| Availabilities | 2 | 2 |
| Reservation Enquiries | 4 | 4 |
| Reservation Settings | 1 | 1 |
| Reservations | 3 | 3 |
| Reservations Tags | 1 | 1 |
| Reviews | 3 | 3 |
| Validations | 1 | 1 |
- Quandoo Vocabulary — Unified taxonomy mapping 10 resources, 7 actions, 10 workflows, and 3 personas across operational (OpenAPI) and capability (Naftiko) dimensions.
- Quandoo Public Partner API Spectral Rules — 31 rules across info, paths, operations, tags, parameters, request bodies, responses, schemas, security, HTTP method, and quality categories enforcing Quandoo API conventions.
- Plans & Pricing — Subscription + per-cover commission model (API Commons Plans 0.1).
- Rate Limits — Token-scoped access, idempotency and conflict semantics (API Commons Rate Limits 0.1).
- FinOps — FOCUS-aligned billing model and meters (FinOps Framework 1.0).
FN: Kin Lane
Email: kin@apievangelist.com