Commerce Layer (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.json: https://raw.githubusercontent.com/api-evangelist/commerce-layer/refs/heads/main/apis.yml

Scope

• Position: Consuming
• Access: 3rd-Party

Tags

• Headless Commerce
• Composable Commerce
• API-First
• Ecommerce
• JSON:API
• OAuth 2.0
• Multi-Market
• Multi-Currency
• B2C
• B2B
• Subscriptions
• Promotions
• Inventory
• Order Management
• Checkout

Timestamps

• Created: 2026-05-25
• Modified: 2026-05-25

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, prices, price lists, markets, stores, inventory (stock items, locations, transfers), customers, customer groups, customer subscriptions, payment gateways (Adyen, Stripe, Braintree, PayPal, Klarna, Checkout.com, Axerve, Satispay), payment methods, tax calculators (Avalara, TaxJar, Vertex, Stripe Tax), shipping methods, shipping zones, carrier accounts, geocoders (Google, Bing), promotions (fixed amount, percentage, free gift, free shipping, BXGY, flex), gift cards, coupons, returns, parcels, packages, webhooks, imports, exports, and tags. 917 path operations across the live OpenAPI 3.1 specification.

• Human URL: https://docs.commercelayer.io/core/
• Base URL: https://{your-organization-slug}.commercelayer.io/api

Tags

• Commerce
• Headless Commerce
• Multi-Market
• JSON:API
• Checkout
• Orders
• Catalog
• Inventory
• Promotions

Properties

• Documentation
• Documentation
• Documentation
• Authentication
• Rate Limits
• Webhooks
• Documentation
• OpenAPI — OpenAPI Specification
• OpenAPI — OpenAPI Specification
• Postman Collection — Postman Collection 2.1
• Open Collection — Open Collection 1.0
• JSON Schema — JSON Schema
• JSON Schema — JSON Schema
• JSON-LD — JSON-LD

Commerce Layer Provisioning API

Programmatic provisioning surface for Commerce Layer organizations, memberships, roles, API credentials, application memberships, identity providers (SSO), permissions, and user invitations. 48 path operations. Required for headless onboarding flows, infrastructure-as-code organization management, and enterprise identity federation. Available on Developer and Enterprise plans (Provisioning API access is an enterprise feature).

• Human URL: https://docs.commercelayer.io/provisioning
• Base URL: https://provisioning.commercelayer.io

Tags

• Administration
• Provisioning
• Organizations
• SSO
• JSON:API

Properties

• Documentation
• Documentation
• OpenAPI — OpenAPI Specification
• OpenAPI — OpenAPI Specification
• Postman Collection — Postman Collection 2.1
• Open Collection — Open Collection 1.0

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) plus frequently-bought-together (FBT) analysis helpers. Useful for KPI dashboards, cohort and funnel reporting, catalog merchandising signals, and feeding downstream warehouses. Commerce Layer also publishes a local MCP server that exposes the Metrics API to AI agents.

• Human URL: https://docs.commercelayer.io/metrics/welcome
• Base URL: https://{your-domain}.commercelayer.io/metrics

Tags

• Analytics
• Metrics
• Reporting
• Commerce Analytics
• Data

Properties

• Documentation
• Documentation
• OpenAPI — OpenAPI Specification
• OpenAPI — OpenAPI Specification
• Postman Collection — Postman Collection 2.1
• Open Collection — Open Collection 1.0
• M C P Server

Common Properties

• Arazzo Workflows — Arazzo Specification
• Portal
• Portal
• Documentation
• Documentation
• Documentation
• Documentation
• Documentation
• Getting Started
• Authentication
• Documentation
• Documentation
• Rate Limits
• Errors
• Webhooks
• Documentation
• Security
• Documentation
• Changelog
• Blog
• Pricing
• About
• Contact
• Privacy Policy
• Terms of Service
• Sign Up
• Login
• Forum
• GitHub Organization
• SDK
• SDK
• SDK
• SDK
• SDK
• C L I
• SDK
• Tool
• Tool
• Tool
• Tool
• Tool
• Tool
• Tool
• M C P Server
• Code Examples
• Code Examples
• Code Examples
• Code Examples
• Code Examples
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Plugins
• Documentation
• Plans
• Rate Limits
• Fin Ops
• Features

Maintainers

FN: Kin Lane Email: info@apievangelist.com URL: https://apievangelist.com