POS & Systems API (Beta)

Welcome to the OneTablet POS & Systems API documentation. This API enables POS systems, Kitchen Display Systems, and back-office tools to receive and manage orders from OneTablet.

Overview

OneTablet aggregates orders from multiple channels and delivers them to your system through a unified API:

• Marketplaces: DoorDash, Uber Eats, Grubhub, and more
• Direct Ordering: Restaurant apps, websites, kiosks
• AI & Voice: Phone ordering systems, AI agents
• Other Channels: Any platform integrated via the Ordering Channel API

All orders are normalized into a consistent format, regardless of their origin.

Capabilities

Feature	Description
Order Retrieval	Fetch orders via REST API with filtering and pagination
Real-time Webhooks	Receive instant notifications for new orders and status changes
Order Management	Mark orders as ready, finished, or cancelled
Delivery Tracking	Monitor courier status for third-party deliveries

Quick Start

1. Get Your API Key

Contact OneTablet technical support to obtain your API key.

2. Make Your First Request

curl -X GET "https://public-api.onetablet.co/api/v1/orders" \
  -H "x-api-key: your-api-key"

3. Set Up Webhooks

Configure your endpoint to receive real-time order notifications.

Authentication

All API requests require an API key in the x-api-key header:

curl -H "x-api-key: your-api-key" https://public-api.onetablet.co/api/v1/orders

Base URL

https://public-api.onetablet.co/api/v1

Error Handling

The API uses standard HTTP status codes:

Code	Description
200	Success
400	Bad Request (validation error)
401	Unauthorized (invalid API key)
404	Not Found
409	Conflict (action conflicts with current state)
429	Too Many Requests (rate limit exceeded)
500	Internal Server Error

Getting Started

• Authentication - Set up API key authentication
• Quick Start - Step-by-step integration guide
• Order Lifecycle - Understand order states and transitions
• Orders API - Retrieve and manage orders
• Webhooks - Real-time notifications