Xenial API
Xenial is an enterprise omnichannel cloud POS and restaurant management platform powering counter, drive-thru, kiosk, online, and delivery ordering for quick-service and multi-unit restaurants, convenience stores, and venues. An unofficial API lets you programmatically pull orders, menus, sales, payments, employees, and loyalty data—and push updates like menu changes, order status, and configuration back into Xenial across every store.
What is Xenial?
Xenial is an enterprise omnichannel cloud POS and restaurant technology platform serving quick-service and full-service restaurants, multi-unit franchises, convenience stores, and entertainment venues globally. Operators use Xenial to run a single connected platform across counter, drive-thru, line-busting, curbside, online, mobile, kiosk, and delivery ordering—plus kitchen management, digital menu boards, enterprise back office and reporting, customer loyalty and engagement, and payment processing—on hardware- and OS-agnostic devices (Windows, iOS, Android).
Core product areas include:
- Cloud POS (counter, drive-thru, line-busting, curbside, delivery across one connected platform)
- Self-order kiosks and online, mobile, and delivery ordering integration
- Drive-thru tools (controller with voice bot/AI, timers, and director tooling)
- Kitchen management and predictive cooking software and hardware
- Indoor and outdoor digital menu boards and signage
- Enterprise back office with advanced reporting, plus loyalty, customer engagement, and payment processing
Common data entities:
- Orders, Order Items, Modifiers, Channels, Tenders
- Menus, Menu Items, Categories, Pricing, Combos
- Payments, Transactions, Refunds, Settlements
- Sales, Daypart Reporting, Voids, Discounts, Taxes
- Employees, Labor, Shifts, Time Punches
- Stores, Locations, Devices, Loyalty Members
The Xenial Integration Challenge
Restaurant brands run high-volume, mission-critical workloads on Xenial every day, but turning that POS and back-office data into reliable API-driven automation is non-trivial:
- Partner-gated access: Xenial's open API is typically provisioned through partner agreements and per-brand enablement rather than open self-serve developer keys
- Multi-channel order sprawl: Counter, drive-thru, kiosk, online, mobile, and delivery each carry their own order shapes, IDs, and status lifecycles to reconcile
- Enterprise multi-unit scale: Menus, pricing, and configuration are managed centrally but vary by store, franchise, and region—generic integrations break across locations
- Hardware- and OS-agnostic deployments: Windows, iOS, and Android devices mean data surfaces and edge behavior differ across the fleet
- Real-time operational pressure: Kitchen, drive-thru timing, and order status need low-latency reads and writes without disrupting live service
- Payments and reconciliation sensitivity: Tenders, settlements, and refunds demand careful idempotency and audit handling across channels
How Supergood Creates Xenial APIs
Supergood reverse-engineers Xenial's authenticated back-office flows and open API surface to deliver a resilient, normalized API layer for your Xenial estate—across every store, channel, and device type.
- Handles username/password and MFA (SMS, email, TOTP) securely for back-office and management surfaces
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across orders, menus, payments, sales, and labor so you integrate once and rely on consistent objects across channels and stores
- Aligns with brand-specific menu hierarchies, pricing, and store configuration to ensure accurate, compliant access
Use Xenial with AI agents: Xenial MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your channels, store footprint, and authentication model.
- Supergood Generates and Validates Your API
We deliver a hardened, production-ready Xenial adapter tailored to your brand configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Xenial evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Xenial brand/tenant using username/password, or MFA and obtain a session token for downstream calls.
Orders
/ordersList orders across counter, drive-thru, kiosk, online, mobile, and delivery channels with filters for store, status, and date range.
Orders
/create_orderSubmit a new order with items, modifiers, channel, and tender details against a store's configured menu.
Menus
/menusRetrieve menus, menu items, categories, combos, and pricing for a store or brand hierarchy.
Payments
/paymentsPull payments, transactions, refunds, and settlement records across channels and tenders.
Reporting
/salesRetrieve sales, daypart, void, discount, and tax reporting from the enterprise back office for a store or region.
Use Cases
Sync omnichannel order and sales data
- Pull orders, items, and tenders from counter, drive-thru, kiosk, online, mobile, and delivery into a single warehouse - Stream sales and daypart reporting to downstream BI and finance tools - Reconcile channel-level order IDs and statuses across every store
Centralize menu and pricing management
- Pull menus, items, modifiers, combos, and pricing across the brand hierarchy - Push menu changes and price updates back into Xenial per store or region - Keep third-party ordering and delivery menus in sync with the POS
Automate payment and settlement reconciliation
- Sync payments, transactions, refunds, and settlements into general ledger and accounting systems - Match tenders to orders across channels for unified financial reporting - Surface chargebacks and discrepancies to reconciliation workflows
Feed labor and store performance analytics
- Pull employee, shift, and time-punch data alongside sales for labor cost analysis - Compare store and franchise performance across the enterprise footprint - Drive workforce and forecasting tools with near real-time operational data
Technical Specifications
Authentication
Username/password, OAuth and MFA (SMS, email, TOTP) handled in a managed session
Connectivity
Authenticated back-office flows plus Xenial's open API surface where exposed to the brand
Response format
Normalized JSON across orders, menus, payments, sales, and labor objects
Rate limits
Adaptive throttling tuned to your estate to avoid Xenial-side limits during live service
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for orders, payments, and sales with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for order creation, order status, payment, and menu changes
Latency
Sub-second reads on cached entities; multi-second writes when posting orders and menu updates
Throughput
Horizontally scaled workers sized to high-volume, multi-unit order and transaction loads
Reliability
Retry, backoff, and idempotency keys for orders, payments, and refunds
Adaptation
Continuous monitoring of Xenial releases and brand-specific configuration drift
Frequently asked questions
Yes. Supergood normalizes orders across counter, drive-thru, line-busting, curbside, kiosk, online, mobile, and delivery so you integrate once and get consistent order objects regardless of channel.
No. Supergood works with your existing Xenial entitlements and authenticated sessions. Formal partner enablement is only required when you specifically need capabilities Xenial brokers exclusively through its partner program.
Each brand is profiled against its configured menu hierarchy, combos, pricing, and store-level overrides. Supergood preserves brand-specific structure and per-store variation rather than forcing a generic schema.
Yes. Beyond reads, the API supports writes such as creating orders, updating order status, and pushing menu and price changes, with idempotency and audit handling for safe, repeatable operations.
Yes. Because Supergood operates against Xenial's authenticated back-office and API surfaces rather than the device layer, the integration is consistent across the hardware- and OS-agnostic fleet.