# Get Started with Limio's API

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.

{% hint style="info" %}
The complete API reference with request/response schemas, parameters, and examples is at [docs.limio.com/api](https://docs.limio.com/api).
{% endhint %}

## 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](https://docs.limio.com/ai/mcp-server/setup) 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](https://docs.limio.com/developers/custom-components/custom-components) deployments programmatically                                                                                            |

## APIs at a glance

| API                                                                           | What it does                                                                                  |
| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| [Checkout API](https://docs.limio.com/api/checkout-api)                       | Create and manage checkout sessions from any channel                                          |
| [Orders API](https://docs.limio.com/api/orders-api)                           | Preview and submit orders — new subscriptions, changes, cancellations, payment updates, gifts |
| [Catalog API](https://docs.limio.com/api/catalog-api)                         | Read offers, pricing, products, pages, and campaign configuration                             |
| [Objects API](https://docs.limio.com/api/objects-api)                         | Query subscriptions, customers, and other record types                                        |
| [Build & Publish API](https://docs.limio.com/api/build-and-publish-api)       | Trigger shop builds and publish deployments                                                   |
| [Journeys API](https://docs.limio.com/api/journeys-api)                       | Create and manage customer journeys                                                           |
| [Session API](https://docs.limio.com/api/session-api)                         | Session-scoped endpoints for authenticated end-users                                          |
| [Integrations API](https://docs.limio.com/api/integrations-api)               | Connect external systems                                                                      |
| [Promo Codes API](https://docs.limio.com/api/promo-codes-api)                 | Validate and apply promotional codes                                                          |
| [External Identities API](https://docs.limio.com/api/external-identities-api) | Link multiple user identities to the same customer                                            |
| [Abandoned Basket API](https://docs.limio.com/api/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](mailto:support@limio.com).

[Set up authentication](https://docs.limio.com/developers/api-documentation/authentication-overview)

## Next steps

* [Authentication overview](https://docs.limio.com/developers/api-documentation/authentication-overview) — get your credentials and make your first authenticated request
* [Webhooks](https://docs.limio.com/developers/webhooks/overview) — listen for commerce events
* [Limio SDK](https://docs.limio.com/developers/limio-sdk/getting-started) — build custom front-end components