Get Started with Limio's API

Overview of Limio's APIs and how to get started.

Limio exposes a set of REST APIs that give you programmatic access to every commerce operation — submitting orders, reading the catalog, managing subscriptions, triggering checkout sessions, and more.

The complete API reference with request/response schemas, parameters, and examples is at docs.limio.com/api.

What developers use Limio's APIs for

Use case	How
Headless pricing & checkout	Build custom pricing pages or checkout flows outside the Limio Page Builder — serve offers, collect payments, and submit orders from any front-end
Self-service portals	Let customers manage their own subscriptions, change plans, update payment methods, or cancel — all driven by API calls from your portal
Assisted & partner checkout	Initiate checkout sessions on behalf of customers — call-centre agents, sales reps, or channel partners selling through a business portal
Feed catalog data to other systems	Pull offers, pricing, and product configuration into your CMS, data warehouse, mobile app, or AI agent
Abandoned cart recovery	Retrieve abandoned baskets, generate recovery links, and trigger re-engagement campaigns with promo codes attached
Programmatic catalog management	Create, update, or query offers and products at scale — useful for bulk pricing changes, demo setup, or automated catalog maintenance. See also the Limio MCP Server for AI-assisted catalog operations
Bulk promo code creation	Generate and manage promotional codes programmatically for campaigns, partnerships, or customer win-back flows
Subscription queries	Query active subscriptions, statuses, and history from downstream systems — power dashboards, support tooling, or entitlement checks
Partner management	Manage partner relationships, enable partners to place orders, and track partner-originated transactions
Monitor builds & deployments	Track the status of shop builds and custom component deployments programmatically

APIs at a glance

API	What it does
Checkout API	Create and manage checkout sessions from any channel
Orders API	Preview and submit orders — new subscriptions, changes, cancellations, payment updates, gifts
Catalog API	Read offers, pricing, products, pages, and campaign configuration
Objects API	Query subscriptions, customers, and other record types
Build & Publish API	Trigger shop builds and publish deployments
Journeys API	Create and manage customer journeys
Session API	Session-scoped endpoints for authenticated end-users
Integrations API	Connect external systems
Promo Codes API	Validate and apply promotional codes
External Identities API	Link multiple user identities to the same customer
Abandoned Basket API	Retrieve and act on abandoned checkout sessions

Authentication

All APIs require an OAuth Bearer Token. This is the standard authentication method for all integrations.

Some Catalog API endpoints accept a publishable API key for read-only access. However, Limio is in the process of moving all endpoints to OAuth Bearer Token. If you are planning a new integration and need to use a publishable API key, please contact Limio.

Set up authentication

Next steps

• Authentication overview — get your credentials and make your first authenticated request

• Webhooks — listen for commerce events

• Limio SDK — build custom front-end components