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 platform 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 (Avalara, TaxJar, Vertex, Stripe Tax), shipping, promotions, subscriptions, returns, and webhooks. It 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.
URL: Visit APIs.json
Run: Capabilities Using Naftiko
- Headless Commerce, Composable Commerce, API-First, Ecommerce, JSON:API, OAuth 2.0, Multi-Market, Multi-Currency, B2C, B2B, Subscriptions, Promotions, Inventory, Order Management, Checkout
- Created: 2026-05-25
- Modified: 2026-05-25
The JSON:API-compliant REST surface that powers headless commerce. 917 path operations across 130+ top-level resources — orders, line items, SKUs, bundles, prices, price lists, markets, stores, inventory (stock items, locations, transfers, reservations), customers, customer groups, customer subscriptions, payment gateways (Adyen, Stripe, Braintree, PayPal, Klarna, Checkout.com, Axerve, Satispay), tax calculators (Avalara, TaxJar, Vertex, Stripe Tax), shipping methods, shipping zones, carrier accounts, geocoders (Google, Bing), promotions (BXGY, percentage, fixed-amount, free-gift, free-shipping, flex), gift cards, coupons, returns, parcels, webhooks, imports, exports, tags.
Base URL: https://{your-organization-slug}.commercelayer.io/api
Human URL: https://docs.commercelayer.io/core/
- Documentation
- Core API Reference
- API Specification
- Authentication
- Rate Limits
- Webhooks
- Event Stream Hub (SSE)
- Public OpenAPI Schema
- OpenAPI (local mirror)
- JSON Schema — Order
- JSON Schema — SKU
- JSON-LD
- Naftiko Capability — Orders
- Naftiko Capability — SKUs
- Naftiko Capability — Customers
- Naftiko Capability — Markets
- Naftiko Capability — Prices
- Naftiko Capability — Shipments
- Naftiko Capability — Promotions
- Naftiko Capability — Webhooks and Events
Programmatic provisioning surface for Commerce Layer organizations, memberships, roles, API credentials, application memberships, identity providers (SSO), permissions, and user invitations. 48 path operations. Available on the Enterprise plan.
Base URL: https://provisioning.commercelayer.io
Human URL: https://docs.commercelayer.io/provisioning
- Documentation
- Provisioning API Reference
- Public OpenAPI Schema
- OpenAPI (local mirror)
- Naftiko Capability — Organizations
- Naftiko Capability — Memberships and Roles
- Naftiko Capability — API Credentials
- Naftiko Capability — Identity Providers
Analytics surface over Commerce Layer's ecommerce history. Five query types — breakdown, date_breakdown, stats, search, export — across four domains: orders, carts, returns, usage. Includes a frequently-bought-together (FBT) analysis helper. Commerce Layer also publishes a local MCP server for the Metrics API so AI agents can query commerce data.
Base URL: https://{your-domain}.commercelayer.io/metrics
Human URL: https://docs.commercelayer.io/metrics/welcome
- Documentation
- Metrics API Specification
- Public OpenAPI Schema
- OpenAPI (local mirror)
- Local MCP Server
- Naftiko Capability — Orders Analytics
- Naftiko Capability — Carts Analytics
- Naftiko Capability — Returns Analytics
- Naftiko Capability — Usage and FBT Analysis
- Plans and Pricing — Free Developer plan, Enterprise plan (custom), Pro-bono plan; Distributed OMS and Promotion Engine add-ons.
- Rate Limits — Sliding-window per IP. Live/test split. Cacheable vs uncacheable read tiers. Auth at 30 req/min. Writes at 200 req/min live / 50 burst per endpoint.
- FinOps — FOCUS-aligned. Subscription + Add-on model, with live-order volume as the primary commerce-unit signal.
- JavaScript / TypeScript SDK
- JavaScript Auth Library
- SDK Utilities (batching, etc.)
- Ruby SDK
- Provisioning SDK
- Commerce Layer CLI — plus 15+ plugins (resources, webhooks, imports, exports, metrics, checkout, orders, provisioning, microstore, seeder, cleanups, triggers, tags, links, token)
- React Components
- drop-in.js
- Hosted micro-frontends: Checkout, Cart, My Account, Identity, Microstore
- Dashboard Apps — orders, customers, shipments, returns, promotions, imports, exports, webhooks, skus, sku-lists, price-lists, inventory, stock-transfers, tags
- CMS integrations: Sanity Commerce, Contentful Commerce, Contentstack Commerce, DatoCMS plugin, Gatsby plugin
- MCP server for Metrics API