Skip to main content

API Platform Overview

Our API platform includes several APIs. Each API plays a specific role in the online ordering application. The your account manager provides the URL to access each API.

API

Description

URL

Data Management

Use the Data Management API to create and review menu items, products, product-prices, taxes, discounts, and other business details. Use the Data Management API to obtain the site identifiers and item numbers required to create and process orders.

{{dm_url}}

Online Ordering

Use the Online Ordering API to create orders, add payment methods, and send the orders to locations for processing. The Online Ordering API provides a complete online ordering experience including tax and discount calculations. It also includes order injection from our Cloud.

{{xoo_url}}

{{mo_url}}

Menu Engine

Menu Engine API provides the menu and calculated price data needed to keep an online menu up to date. It exposes menus in Data Management to integrators.

{{xme_url}}

Chef Kitchen Management

Chef Kitchen Management API provides the Chef Reporting and Local Sales APIs for transactional data.

Digital Menu Board

Digital Menu Board API presents dynamic and vivid graphics and video elements to guests at the counter and at the drive thru.

{{distributor_url}}

Genius Drive Thru

Genius Drive Thru is a customer-facing API that supplies drive thru event data.

{{dtd_url}}

Omni-Channel Ordering

Omni-Channel Ordering allows third parties and affiliates to communicate with our suite products.

{{omni_url}}

Back Office

Back Office serves multi-unit restaurant brands and franchisees, often in the Quick Service Restaurant (QSR) and Fast Casual Restaurant markets.

{{bo_url}}

Portal

Portal API is the first administration layer of the our Cloud product suite. The Portal establishes access to all of our other Cloud components.

{{portal_ui_url}}

Staff

Staff API provides a set of resources used to manage employee records, schedules, payroll, and other typical back office functions. It allows employees to be injected into the integrator's system.

{{boh_staff_ui_url}}

Data Stream

Data Stream API publishes JSON formatted objects to a configurable webhook URL so that integrators and customers can use the data in business management or analysis software outside of our system. Data Stream API is a real-time data feed straight from Pipeline.

{{whstd_url}}

Gift and Loyalty

Gift and Loyalty API adds support for gift card payments and loyalty programs to existing point of sale (POS) devices and applications. Gift and Loyalty API acts as a middleware between gift and loyalty providers and underlying POS systems.

{{xgl_url}}

Genius Kitchen

Genius Kitchen API supports a fully-featured kitchen management system that enables the kitchen staff to serve guests both timely and accurately.

{{xkm}}

Notification

The Notification service provides customers and integrators the ability to subscribe to notifications about changes to a specific company's orders and data.

{{xssn_url}}

Payment Router

Payment Router handles accumulative order features, such as creating a bar tab. Payment Router API acts as a middleware service between payment providers and underlying POS systems.

{{xpr_url}}

Pipeline

The Pipeline service supports data transfer between components of the Portal API and external integrators, including POS API.

Reporting

Use Reporting API to access all reporting for each of the Portal API modules. Reporting API is ideal for the pulling of reporting data once a day.

{{reporting_api_url}}

Venue Inventory

Venue Inventory API provides the venues-based inventory controls required to order, receive, and transfer product, track on-hand quantities, track cost, and perform stand worksheet end counts.

{{XVI_url}}

Classic Portal API

The Class ic Portal API includes operations for generating the tokens used to authenticate the application with the our suite. The Classic Portal API operations also create companies and sites, set roles and permissions, and integrate with our other products.

{{portal_url}}

We offer the following in-store components:

Component

Description

POS

POS API is a cloud-based, point of sale solution that provides a variety of complimentary applications, services, and integrations within its suite of services including reporting, analytics, loyalty, and back office.

POS Event Stream

POS Event Stream API provides a real-time feed of event and order information from POS API to client applications. It is an in-store, local data stream.

Partner Relay

Partner Relay API enables retailers to look up product inventory in real time through POS devices.

Customer Facing Display

Customer Facing Display is able to display customer orders from a third-party device. This device is usually a POS terminal.

Encounter POS

Encounter POS is a combination of the traditional server-based POS and a cloud-based solution. Includes documentation on Encounter Kiosk API.

To set up an online ordering service:

  • Your account manager assists with the initial setup. For more information, see Setup.

  • Your account manager assists with the generation of credentials to send in requests to the our APIs.

  • Once setup and credential generation are complete, use the Online Ordering API to create and send orders. For more information, see Placing an Order and Online Ordering Operations.

The Order Modifications topic provides details about optional menu and order processing features of Online Ordering API.

All APIs in our Platform require certain authentication and permissions information in request and response messages. Authentication and Headers provides details and instructions for acquiring and including this information in your calls to our APIs.

Additional API information includes the following:

  • Getting Started - Information about the API, prerequisites, and setup requirements.

  • Operation Definitions - The endpoints, data models, and code samples for requests to the API and responses.

For our technical support, go to Contact Support or https://www.xenial.com/support/.

Getting Started Documentation Overview

Similar to Getting Started with our APIs, the APIs have their own Getting Started sections. These sections include the following information, if applicable to the API:

  • API Overview - A description of the service.

  • Prerequisites - The requirements for accessing the API.

  • Setup - The step-by-step instructions for accessing the API.

Operation Definitions Overview

The API documentation includes Operation Definitions which are organized in the following way:

  • Endpoint - A digital location where the API receives a request about a specific service on its server. Our API endpoint documentation includes the required request format including the Headers.

  • Data Model - The body for the service request or the API response to the request.

  • Sample Code - A snippet of code for the service request or the API response to the request.

Headers

Authentication and location information is required for all requests to the Online Ordering and Data Management APIs.  It is necessary to include the following header information with all requests:

  • CONTENT-TYPE

  • AUTHORIZATION

  • X-COMPANY-ID

  • X-SITE-IDs

The accepted header values are as follows:

Field Name

Value

Required

Description

CONTENT-TYPE

application/json

Yes

AUTHORIZATION

Integrator-token, site-token, or access-token

Yes

An authentication token generated using a key identifier and secret key. Authenticates requests to the API.

X-COMPANY-ID

company_id

Yes

A unique company identifier (UID) provided by us

X-SITE-IDs

site_id

Yes

The UID of the location that receives the order, defined during onboarding and obtained using the Data Management API.