For Agents
Manage restaurant menus, dine-in and takeout orders, staff shifts, and sales reporting in Lightspeed K-Series via 22 bearer-authenticated endpoints.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Lightspeed Restaurant K-Series API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Lightspeed Restaurant K-Series API.
Create dine-in and takeout orders against a Lightspeed Restaurant K-Series business
List menus and load full menu definitions including categories and modifier groups
Create, update, and delete rich items by SKU for menu engineering
GET STARTED
Use for: Create a takeout order for a Lightspeed restaurant business, I want to add a new menu item to a Lightspeed K-Series restaurant, List all sales for a given Lightspeed business in the last 24 hours, Get the receipt for a specific order reference
Not supported: Does not handle retail e-commerce, payment-processor onboarding, or hardware fulfillment — use for Lightspeed Restaurant K-Series order, menu, and staff operations only.
Jentic publishes the only available OpenAPI specification for Lightspeed Restaurant K-Series API, keeping it validated and agent-ready. The K-Series API gives restaurants programmatic access to menus, items, dine-in and takeout orders, staff, financials, and webhooks across multi-business operations. Twenty-two endpoints cover business listing, menu loading, order creation, rich item CRUD, shift and POS staff management, financial and sales reporting, and receipt retrieval. Authentication uses HTTP bearer tokens and supports both trial and production base URLs.
List shifts, manage POS staff, and retrieve receipts by reference
Pull sales, financial, tax-rate, and payment-method data for accounting reconciliation
Manage webhook subscriptions for order, payment, and staff event notifications
Patterns agents use Lightspeed Restaurant K-Series API for, with concrete tasks.
★ Online Ordering Integration
Connect a third-party ordering channel to Lightspeed K-Series by creating dine-in or takeout orders through the API. POST /o/op/1/order/local and POST /o/op/1/order/to-go accept order line items with rich-item SKUs and modifiers. Replaces manual order entry for delivery aggregators and direct online ordering apps.
Create a takeout order against business ID 'biz-77' with items 'sku-burger' and 'sku-fries' and customer phone '+15551234567'
Menu Engineering and Sync
Keep menus and rich items in sync between a central menu-management system and individual restaurant locations. The /rich-items endpoints expose full CRUD by SKU, and /o/op/1/menu/load/{menuId} returns the live menu structure. Enables central marketing teams to push changes to dozens of locations in a single workflow.
Create rich item with SKU 'sku-special-2026' priced at $14.99 and add it to menu ID 'menu-spring'
Sales and Financial Reporting
Pull sales, tax-rate, and financial data nightly into a data warehouse for restaurant analytics. The /sales, /financials, /tax-rates, and /payment-methods endpoints expose reporting-grade data per business. Replaces CSV exports with structured pulls into BI tools.
Pull yesterday's sales for business ID 'biz-77' and post a daily summary with gross sales by payment method
AI Agent Restaurant Assistant
An AI agent uses Jentic to discover Lightspeed K-Series operations by intent and creates orders, queries menus, and pulls receipts on a manager's behalf. Webhook subscriptions let the agent react to new orders. Credentials are isolated through Jentic so the bearer token never enters agent context.
Search Jentic for 'create a Lightspeed takeout order', load the operation schema, and execute it with the customer's order details
22 endpoints — jentic publishes the only available openapi specification for lightspeed restaurant k-series api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/o/op/1/order/local
Create a dine-in order
/o/op/1/order/to-go
Create a takeout order
/o/op/1/menu/load/{menuId}
Load a full menu by ID
/rich-items
Create or update a rich menu item
/sales
Get sales data for a business
/webhooks
Create a webhook subscription
/o/op/1/order/local
Create a dine-in order
/o/op/1/order/to-go
Create a takeout order
/o/op/1/menu/load/{menuId}
Load a full menu by ID
/rich-items
Create or update a rich menu item
/sales
Get sales data for a business
Three things that make agents converge on Jentic-routed access.
Credential isolation
Lightspeed bearer tokens are stored encrypted in the Jentic MAXsystem vault and injected per request. Agents never see the raw token, and per-business credentials stay isolated from each other.
Intent-based discovery
Agents search by intent (e.g., 'create a Lightspeed takeout order') and Jentic returns the matching K-Series operation across the 22 endpoints with the full request schema.
Time to first call
Direct K-Series integration: 2-4 days for auth, multi-business handling, and webhook setup. Through Jentic: about 1 hour — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Lightspeed Restaurant K-Series API through Jentic.
Why is there no official OpenAPI spec for Lightspeed Restaurant K-Series API?
Lightspeed does not publish a maintained OpenAPI specification for the Restaurant K-Series API. Jentic generates and maintains this spec so that AI agents and developers can call the K-Series API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Lightspeed Restaurant K-Series API use?
It uses HTTP bearer authentication. Tokens are issued by Lightspeed for each business and passed in the Authorization header. Through Jentic, bearer tokens are stored in the MAXsystem vault and injected per request.
Can I create both dine-in and takeout orders with this API?
Yes. POST /o/op/1/order/local creates dine-in orders and POST /o/op/1/order/to-go creates takeout orders. Both accept line items with rich-item SKUs and modifiers.
What are the rate limits for the Lightspeed K-Series API?
The spec does not document explicit rate limits. Treat the API as moderately throttled per business token; respect HTTP 429 responses with a Retry-After header and prefer webhook subscriptions over polling for order updates.
How do I subscribe to new-order webhooks through Jentic?
Run pip install jentic, then search Jentic with 'subscribe to Lightspeed webhooks' to retrieve POST /webhooks. Execute it with your callback URL and event types; Jentic handles the bearer token automatically.
Is the Lightspeed Restaurant K-Series API free?
API access is included with paid Lightspeed Restaurant K-Series subscriptions. There is no free tier; pricing depends on the venue plan.
/webhooks
Create a webhook subscription