TouchBistro API
Programmatically access TouchBistro restaurant POS data—menus, orders, tables, payments, guests, and reservations—with a stable REST API. Supergood builds and operates production-grade, unofficial TouchBistro integrations so your team can automate FOH/BOH workflows without heavy custom engineering.
What is TouchBistro?
TouchBistro is a restaurant point-of-sale platform that centralizes front-of-house operations, menu and inventory control, payments, guest engagement, and reporting across single-location and multi-location hospitality businesses. Teams use TouchBistro to run tableside ordering, manage menus and modifiers, track table status and seatings, process payments and tips, manage reservations and loyalty programs, and reconcile end-of-day reports.
Core product areas include:
- POS & Ordering (Tables, Checks/Tabs, Split Bills, Modifiers, Combos)
- Menu & Inventory Management (Menu Items, Categories, Modifier Groups, Availability, Ingredients)
- Payments & Financials (Card Processing, Tips, Refunds/Void, Discounts, Taxes, Gift Cards)
- Guest Experience (Reservations, Online Ordering, Loyalty, Promotions, Receipts)
- Staff & Operations (Users, Roles/Permissions, Shifts/Time Clock, Floor Plan, KDS)
Common data entities:
- Restaurants/Locations and Devices
- Users/Staff and Roles/Permissions
- Tables/Sections and Seatings
- Orders/Checks and Order Items/Modifiers
- Menus, Categories, Menu Items, Modifier Groups
- Inventory Items and Ingredients
- Customers/Guests and Reservations
- Payments/Transactions, Tips, Discounts, Taxes
The TouchBistro Integration Challenge
Restaurant teams rely on TouchBistro every service, but turning POS-centric workflows into API-driven automation is non-trivial:
- Offline-first devices: iPad terminals can operate offline and sync later, complicating real-time data capture and idempotency
- Complex order structures: Split checks, shared items, nested modifiers, combos, and voids require careful normalization
- Payments and tips: PCI constraints, tokenized cards, partial authorizations, refunds/chargebacks, and tip adjustments must be modeled precisely
- Multi-module data: Reservations, loyalty, and online ordering may be separate modules with different views and entitlements
- Multi-location menus: Price overrides, item availability, and specials vary by venue and time/day
- Export friction: Many operators rely on emailed reports/CSV exports; direct APIs may be limited to partners or incur additional fees, slowing automation
- Authentication complexity: Device-based sessions, staff roles and MFA/ for back-office portals complicate headless integration
How Supergood Creates TouchBistro APIs
Supergood reverse-engineers authenticated browser and device flows to deliver a resilient API endpoint layer for your TouchBistro tenant.
- Handles username/password, partner portals, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh, device-aware cookies, and change detection
- Normalizes nested POS structures (modifiers, splits, discounts, taxes) into consistent schemas
- Aligns with customer entitlements and role-based permissions to ensure compliant access
- Manages offline/online state and reconciliation to prevent duplicates and lost events
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened TouchBistro adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as TouchBistro evolves.
API Endpoints
Authentication
/sessionsEstablish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and portal flows when enabled. Returns a short-lived auth token maintained by the platform.
Authentication
/sessions/refreshRefresh an existing token to keep sessions uninterrupted.
Orders
/ordersList orders/checks with filters and summary details.
Orders
/ordersCreate a new order/check, typically from an online ordering or kiosk flow.
Menu Items
/menu/items/{menuItemId}Update price and availability for a menu item, including time-boxed specials.
Payments
/payments/transactionsList payment transactions including tips, discounts, and settlement metadata.
Use Cases
Order & Guest Data Sync
- Mirror orders, checks, and payments into internal systems for analytics and operations - Enrich CRM with guest profiles, reservations, and visit history - Keep service type (dine-in/takeout/delivery) and table status accurate for dispatch and staffing
Menu & Pricing Automation
- Update prices, modifier availability, and daily specials from your catalog/PIM - Push out-of-stock flags based on inventory and supplier feeds - Coordinate menu changes across multi-location footprints with time-boxed promotions
Tables & FOH Operations
- Ingest table/section seatings to power waitlist and host workflows - Sync KDS statuses and order progress to your kitchen orchestration or delivery systems - Trigger notifications to front-of-house staff based on SLA breaches
Payments & Accounting Sync
- Normalize transactions, tips, discounts, and taxes for ERP/accounting (e.g., QuickBooks, Xero) - Automate refunds and partial voids with audit trails - Reconcile settlements with gateway/batch reports and flag variance
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP) and where enabled; supports service accounts or customer-managed credentials
Response format
JSON with consistent resource schemas and pagination across orders, menus, tables, payments
Rate limits
Tuned for hospitality throughput while honoring customer entitlements and usage controls
Session management
Automatic reauth and device/session rotation with health checks
Data freshness
Near real-time retrieval of orders, menu updates, payments, reservations; reconciliation for offline device syncs
Security
Encrypted transport, scoped tokens, and audit logging; respects TouchBistro role-based permissions
Webhooks
Optional asynchronous delivery for long-running workflows (e.g., online orders, refunds, table status changes)
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume order and payment sync across busy service windows
Reliability
Retry logic, backoff, and idempotency keys minimize duplicate actions and reflect late-arriving device syncs
Adaptation
Continuous monitoring for UI/API changes with rapid adapter updates
Frequently asked questions
Supergood supports workflows across commonly used modules such as POS & Ordering (Tables, Checks, Modifiers), Menu & Inventory (Items, Categories, Availability), Payments & Financials (Card Transactions, Tips, Discounts/Taxes), and Guest Experience (Reservations, Loyalty), subject to your licensing and entitlements. We scope coverage during integration assessment.
We normalize POS line items with explicit references for shared quantities, split allocations, and modifier hierarchies. Totals (subtotal, discounts, taxes, tips) are modeled per check and per payment to support precise reconciliation.
We track device sync states and perform reconciliation passes to capture late-arriving updates. Idempotency keys and change detection prevent duplicates while keeping downstream systems current.
Yes. We normalize transactions, tips, discounts, and tax breakdowns to match your ERP/accounting schema (e.g., QuickBooks, Xero) and deliver updates via webhooks or polling while complying with rate and permission constraints.
Where enabled, we can ingest reservations, guest profiles, and loyalty balances/activities, and expose endpoints to create/update reservations or apply promotions—aligned with your tenant's entitlements.
Yes. We support creating refunds/voids with audit trails and can propagate those back to TouchBistro while preserving original order/payment references.