Commerce Layer
Commerce Layer is the headless, multi-market commerce API used by global brands to sell everywhere — web, mobile, in-store, chatbot, AI agent, and IoT. The company exposes a JSON:API-compliant Core API with 130+ top-level resources covering orders, line items, SKUs, bundles, prices, markets, stores, inventory, customers, payments (Adyen, Stripe, Braintree, PayPal, Klarna, Checkout.com), tax calculation (Avalara, TaxJar, Vertex, Stripe Tax), shipping, promotions, subscriptions, returns, and webhooks. The platform also ships a Provisioning API for organizations/SSO/credentials and a Metrics API for analytics (with a local MCP server for AI agents), plus hosted micro-frontends, dashboard apps, a CLI, CMS integrations, and SDKs for JavaScript/TypeScript, Ruby, React, and drop-in.js.
APIs
Commerce Layer Core API
The Commerce Layer Core API is the JSON:API-compliant REST API that powers headless commerce. It exposes 130+ top-level resources covering orders, line items, SKUs, bundles, pri...
Commerce Layer Provisioning API
Programmatic provisioning surface for Commerce Layer organizations, memberships, roles, API credentials, application memberships, identity providers (SSO), permissions, and user...
Commerce Layer Metrics API
Analytics surface over Commerce Layer's ecommerce history. Five query types (breakdown, date_breakdown, stats, search, export) across four domains (orders, carts, returns, usage...
Collections
Commerce Layer API
POSTMANCommerce Layer Metrics API
POSTMANCommerce Layer Provisioning API
POSTMANCommerce Layer API
OPENArazzo Workflows
Commerce Layer Add Line Item and Read It Back
Add a SKU line item to an existing order and retrieve the created line item.
ARAZZOCommerce Layer Build Cart and Branch on Order Status
Create an order, add a line item, read the order, and branch to place it only when it is in draft.
ARAZZOCommerce Layer Create and Ship a Shipment
Create a shipment for an order, mark it ready to ship, then ship it.
ARAZZOCommerce Layer Create Customer, Address, and Order
Onboard a customer, save a customer address book entry, then open an order for them.
ARAZZOCommerce Layer Create Customer with Address Book Entry
Create a customer, create an address, and link it as a customer address book entry.
ARAZZOCommerce Layer Create Market with Payment Method
Create a market tied to merchant, price list, and inventory model, then add a payment method to it.
ARAZZOCommerce Layer Create Order and Add Line Item
Create a draft order in a market, add a SKU line item to it, then read the order back.
ARAZZOCommerce Layer Create Return with Line Item
Open a return against an order, add a return line item for an order line item, then request it.
ARAZZOCommerce Layer Create Shipment for Order
Create a shipment for an order from a stock location, then advance it toward ready to ship.
ARAZZOCommerce Layer Create SKU and Price
Create a SKU under a shipping category, then create a price for it in a price list.
ARAZZOCommerce Layer Create SKU, Price It, and Read SKU Back
Create a SKU, create a price for it in a price list, then retrieve the SKU.
ARAZZOCommerce Layer Guest Order Add Line Item and Place
Open a guest order, add a SKU line item, then place the order in one flow.
ARAZZOCommerce Layer Add Payment Method and Place Order
Attach a payment method to an order and then transition the order to placed.
ARAZZOCommerce Layer Add Two Line Items to an Order
Create an order, then add two SKU line items to it and read the recalculated totals.
ARAZZOCommerce Layer Refresh and Place an Order
Refresh an order's prices and taxes, then place it once recalculated.
ARAZZOCommerce Layer Set Order Shipping and Billing Addresses
Create a shipping address and a billing address, then attach both to an existing order.
ARAZZOCommerce Layer Place and Capture an Order
Place an order, read its status, then capture payment only once it is placed.
ARAZZOGraphQL
Commerce Layer GraphQL Schema
Commerce Layer is a headless, multi-market commerce API built on a JSON:API-compliant REST surface. This document describes a conceptual GraphQL schema that maps the Commerce La...
GRAPHQL