Tock API
Tock is a reservations, events, and guest-data platform for restaurants, bars, and wineries, now part of American Express and merging into Resy. Its API and webhooks—gated behind Premium plans and an email-request key—let you export historical reservation and guest data, receive real-time reservation and guest-profile updates, and ingest basic guest records, while reservation creation and cancellation remain dashboard-only.
What is Tock?
Tock is a reservations, table-management, and event-booking platform for restaurants, bars, and wineries, letting guests book reservations, takeout, and ticketed culinary experiences around the world. Operators use Tock to manage pre-paid bookings and experiences, run events, capture rich guest profiles, and reconcile payments. Acquired by American Express from Squarespace in October 2024, Tock is being combined with Resy into a single reservation platform, bringing its fine-dining and winery inventory under the Resy brand.
Core product areas include:
- Reservations and table management (bookings, walk-ins, party states, seating)
- Experiences and events (ticketed dinners, tastings, add-ons, pre-paid menus)
- Takeout and pickup ordering
- Guest profiles and CRM (visit history, spend, tags, dietary preferences, occasions)
- Payments, refunds, payouts, and discounts on pre-paid bookings
- Data Exports API, Guest Profile Ingest API, and real-time webhooks
Common data entities:
- Reservations (ID, business, date/time, party size, confirmation code, party state)
- Experiences, add-on items, and included menu selections
- Pricing and payments (subtotal, taxes, service charges, gratuity, fees, refunds, payouts)
- Guest profiles (contact, visit and spend history, dietary restrictions, preferences)
- Tags, notes, and special occasions at business and business-group levels
- Operational data (assigned tables, seating areas, servers, feedback, visit metadata)
The Tock Integration Challenge
Restaurants run daily service on Tock, but turning its data into programmatic automation is gated by plan tier, manual key provisioning, and deliberate read-only limits:
- Premium-plan gate: only Premium and Premium Unlimited plans are eligible to receive API or webhook access at all
- Email-request provisioning: API keys and webhooks are issued only after emailing integrate@tockhq.com from an Account Owner on the Dashboard Team page—there is no self-serve developer portal
- Read-only reservations: reservation data cannot be created, modified, or cancelled through the API—those actions stay in the Tock dashboard
- Batch-lagged exports: the Data Exports API generates files only twice daily, each reflecting data as of roughly 12 hours prior—real-time needs depend on webhooks
- Narrow write surface: the Guest Profile Ingest API only allows adding and updating basic guest information and tags, not bookings or payments
- Platform consolidation: with Tock merging into Resy under American Express, integrations must absorb branding, endpoint, and ownership changes during the transition
- Patron-owned fields: dietary restrictions and preferences are patron-controlled and business-read-only, so write-back has to respect ownership boundaries
How Supergood Creates Tock APIs
Supergood reverse-engineers authenticated Tock dashboard flows alongside the official Data Exports, Guest Profile Ingest, and webhook surfaces to deliver a unified, real-time API for your venue—even on data that the public API leaves read-only or batch-lagged.
- Authenticates against the Tock dashboard and manages sessions, including MFA, with automatic refresh
- Normalizes reservations, experiences, payments, and guest profiles into consistent JSON objects across locations and the business group
- Fills gaps the public API leaves—near real-time reads where exports lag, and richer reservation context the ingest API does not write
- Respects patron-owned versus business-managed field boundaries and your plan entitlements
Use Tock with AI agents: Tock MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your Tock plan tier, locations, and the reservation, experience, and guest data you need.
- Supergood Generates and Validates Your API
We deliver a production-ready Tock adapter tailored to your venue's configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adaptation as Tock evolves and merges into Resy.
API Endpoints
Authentication
/authenticateAuthenticate to a Tock business using dashboard credentials or an API key and obtain a session for downstream calls.
Reservations
/reservationsList reservations and walk-ins with filters for date, party state, experience, and business location.
Reservations
/reservations/{id}Retrieve a single reservation with pricing, payments, seating, servers, tags, and guest responses.
Experiences
/experiencesList bookable experiences, ticketed events, add-on items, and included menu selections.
Guests
/guestsRetrieve guest profiles with contact details, visit and spend history, preferences, tags, and occasions.
Guests
/guestsAdd or update basic guest information and profile tags via the Guest Profile Ingest surface.
Use Cases
Sync reservation and guest data into your warehouse
- Pull reservations, walk-ins, experiences, and payments across all Tock locations - Stream party-state changes (expected, arrived, seated, no-show, cancelled) in real time - Reconcile guest profiles, visit history, and spend into a unified customer 360
Power CRM and marketing automation
- Push visit, spend, and occasion data into email and loyalty platforms - Ingest enriched guest profiles and tags back into Tock for better service - Trigger win-back and VIP campaigns from real-time guest-profile webhooks
Reconcile payments and event revenue
- Match subtotals, taxes, service charges, gratuity, and fees against your accounting system - Track refunds, payouts, and discounts on pre-paid bookings and ticketed events - Surface deposits and amounts due for finance reporting
Bridge Tock data into operations dashboards
- Feed seating, server, and feedback data into staffing and service-quality tools - Aggregate experience and event demand across venues for forecasting - Monitor real-time reservation flow without manual export downloads
Technical Specifications
Authentication
API key issued via integrate@tockhq.com, plus authenticated dashboard sessions and MFA handled in a managed session
Connectivity
Official Data Exports API, Guest Profile Ingest API, and real-time webhooks, supplemented by authenticated dashboard flows
Response format
Normalized JSON across reservations, experiences, payments, and guest-profile objects
Rate limits
Adaptive throttling tuned to your business to stay within Tock-side limits
Session management
Automatic session refresh, MFA handling, and API-key rotation
Data freshness
Near real-time via webhooks; twice-daily Data Exports otherwise reflect data as of ~12 hours prior
Security
Encrypted credential vault, scoped tokens, SOC 2-aligned controls, and audit logging
Webhooks
Real-time callbacks for reservation, walk-in, and guest-profile updates
Latency
Sub-second reads on cached reservation and guest entities; multi-second writes on guest ingest
Throughput
Horizontally scaled workers sized to multi-location reservation and guest volume
Reliability
Retry, backoff, and idempotency keys for guest ingest and webhook reconciliation
Adaptation
Continuous monitoring of Tock releases and the ongoing merge into Resy under American Express
Frequently asked questions
Yes. Only Premium and Premium Unlimited plans are eligible for API or webhook access. Keys are requested by emailing integrate@tockhq.com from an Account Owner on your Dashboard Team page; Supergood works with whatever entitlements your plan provides.
Not through Tock's public API—reservation creation, modification, and cancellation remain dashboard-only, and the Guest Profile Ingest API only writes basic guest information. Supergood reverse-engineers authenticated dashboard flows to extend automation beyond those limits where your permissions allow.
Tock's Data Exports API runs twice daily with roughly a 12-hour lag. Supergood combines the real-time reservation and guest-profile webhooks with authenticated reads to deliver near real-time data rather than waiting on batch files.
American Express is combining Tock and Resy into a single platform. Supergood continuously monitors branding, endpoint, and ownership changes and adapts your adapter so the integration keeps working through the transition.
Guest profiles include contact details, visit and spend history, dietary restrictions and preferences, tags, notes, and special occasions at both business and business-group levels. Supergood respects patron-owned versus business-managed field boundaries when reading and writing.