Introduction

A detailed list of all Commerce Layer core resources

Commerce Layer is a flexible commerce API that features 400+ endpoints. This is the detailed reference where you can explore the complete list of our core resources.

Commerce Layer now supports explicit API versioning, and we just released a new version — see API versioning to learn how it works. This reference documents the legacy 2017-08 version, still the default when no version is specified. We encourage you to start planning your move to the new 2026-05 version: the legacy version will now only be maintained on a bug-fix basis, while all new features — starting with the redesigned payments flow — are developed for the latest one exclusively.

The 2026-05 version itself is stable, but the resources it introduces — the redesigned payment flow in particular — are currently in beta and may still evolve as we refine them based on real-world usage. For now the API reference is the only publicly available documentation for the new version. The related Getting started guide and How-tos are coming soon. In the meantime, they can be shared privately with teams who want to start checking or integrating against the new payments flow — reach out to us if you're interested.

How it works

For each single resource you can find:

• The resource object and its fields, attributes, and relationships.
• The allowed CRUD operations you can perform on the related endpoint with basic examples of the request/response format.

More to read

See our Getting started guide for basic information on how to fetch, create, update and delete resources or any other instruction you need to interact with our API.

Check our changelog to stay up-to-date with any changes we make on the APIs, apps, and open-source projects (including versioning, product releases, new features, and general improvements).

Read our how-tos for step-by-step tutorials and best practices on how to handle the most common ecommerce scenarios.

Try out our Metrics API and see how it can enable you to gather and aggregate useful data that you can leverage to measure the health and performance of your ecommerce business.

Do you need to manage provisioning tasks programmatically, extend our Dashboard, or even build your own? Leverage our Provisioning API and exercise greater control over your organizational structure and user roles.

Would you like to benefit from a DSL that enables you to define promotional rules? If you're an enterprise customer, you can ask to test our Rules Engine and start setting up almost any kind of promotions to boost your sales, from the simplest to the most complex.