All the strings passed to the API must be UTF-8 encoded.
The guide that follows is your reference for all the operations that you can perform on the API resources and contains all the information you need to get a comprehensive overview of how it works.
All API requests must be made over HTTPS to the following base endpoint:
Where yourdomain is the unique subdomain of your organization.
Commerce Layer commerce API features 400+ endpoints. Check our API reference for the complete and updated list of all the core resources, in detail. For each single resource you will 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.
Commerce Layer implements the industry-standard OAuth 2.0 protocol to manage clients' authorization. It defines three types of applications (API clients): sales channel, integration, webapp. Which client to use depends on your specific use case. You can leverage our how-tos to get started with the most popular use cases (more to come).
For each organization, you can work either in test mode (default) or live mode.
Working in test mode is free forever. You can try Commerce Layer in test mode as long as you need to.
Test mode also provides you with a development environment after the go-live. All API calls are identical between the two environments. Use test or live application credentials to make the switch.
Switching to live mode means opening a completely new (empty) environment where you can get real orders, with different credentials to access. If you want to replicate your test setup in the live environment you can export most of the resources (SKUs, prices, stock, etc.) from your test env and import them to the live one. If you import orders, you will be charged for the placed ones, according to the pricing plan you subscribed to.
Open-source projects and developer tools
JS SDK, CLI, and React components are available as open-source projects. More libraries and SDKs for the most popular languages are coming soon.
To stay up-to-date with any changes we make on Commerce Layer APIs, apps, and open-source projects (including versioning, product releases, new features, and general improvements), make sure to check our changelog.