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.
Reference-quality API operations across every facet — a rich contract, published governance, transparent operations, and machine-readable commercial terms.
API Evangelist profiles Commerce Layer the way a machine reads it — 209 machine-readable artifacts across 148 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.
Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — Commerce Layer scores 74.2/100 (exemplar), with a separate agent-readiness read of 80/100 (agent native). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.
Kin Score
This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.
How we profile Commerce Layer
Each block below is one kind of artifact we hold for Commerce Layer. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.
APIs 148
Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.
Individual APIs this provider publishes, each with its own machine-readable definition.
Commerce Layer addresses API
resource type
Commerce Layer adjustments API
resource type
Commerce Layer adyen_gateways API
resource type
Commerce Layer adyen_payments API
resource type
Commerce Layer analysis API
Operations with analysis resource
Commerce Layer api_credentials API
resource type
Commerce Layer application API
resource type
Commerce Layer application_memberships API
resource type
Commerce Layer attachments API
resource type
Commerce Layer authorizations API
resource type
Commerce Layer avalara_accounts API
resource type
Commerce Layer axerve_gateways API
resource type
Commerce Layer axerve_payments API
resource type
Commerce Layer bing_geocoders API
resource type
Commerce Layer braintree_gateways API
resource type
Commerce Layer braintree_payments API
resource type
Commerce Layer bundles API
resource type
Commerce Layer buy_x_pay_y_promotions API
resource type
Commerce Layer captures API
resource type
Commerce Layer carrier_accounts API
resource type
Commerce Layer carts API
Operations with carts resource
Commerce Layer checkout_com_gateways API
resource type
Commerce Layer checkout_com_payments API
resource type
Commerce Layer cleanups API
resource type
Commerce Layer coupon_codes_promotion_rules API
resource type
Commerce Layer coupon_recipients API
resource type
Commerce Layer coupons API
resource type
Commerce Layer custom_promotion_rules API
resource type
Commerce Layer customer_addresses API
resource type
Commerce Layer customer_groups API
resource type
Commerce Layer customer_password_resets API
resource type
Commerce Layer customer_payment_sources API
resource type
Commerce Layer customer_subscriptions API
resource type
Commerce Layer customers API
resource type
Commerce Layer delivery_lead_times API
resource type
Commerce Layer discount_engine_items API
resource type
Commerce Layer discount_engines API
resource type
Commerce Layer easypost_pickups API
resource type
Commerce Layer event_callbacks API
resource type
Commerce Layer event_stores API
resource type
Commerce Layer events API
resource type
Commerce Layer exports API
resource type
Commerce Layer external_gateways API
resource type
Commerce Layer external_payments API
resource type
Commerce Layer external_promotions API
resource type
Commerce Layer external_tax_calculators API
resource type
Commerce Layer fixed_amount_promotions API
resource type
Commerce Layer fixed_price_promotions API
resource type
Commerce Layer flex_promotions API
resource type
Commerce Layer free_gift_promotions API
resource type
Commerce Layer free_shipping_promotions API
resource type
Commerce Layer geocoders API
resource type
Commerce Layer gift_card_recipients API
resource type
Commerce Layer gift_cards API
resource type
Commerce Layer google_geocoders API
resource type
Commerce Layer has_many API
relationship kind
Commerce Layer has_one API
relationship kind
Commerce Layer identity_providers API
resource type
Commerce Layer imports API
resource type
Commerce Layer in_stock_subscriptions API
resource type
Commerce Layer inventory_models API
resource type
Commerce Layer inventory_return_locations API
resource type
Commerce Layer inventory_stock_locations API
resource type
Commerce Layer klarna_gateways API
resource type
Commerce Layer klarna_payments API
resource type
Commerce Layer line_item_options API
resource type
Commerce Layer line_items API
resource type
Commerce Layer links API
resource type
Commerce Layer manual_gateways API
resource type
Commerce Layer manual_tax_calculators API
resource type
Commerce Layer markets API
resource type
Commerce Layer membership_profiles API
resource type
Commerce Layer memberships API
resource type
Commerce Layer merchants API
resource type
Commerce Layer notifications API
resource type
Commerce Layer order_amount_promotion_rules API
resource type
Commerce Layer order_copies API
resource type
Commerce Layer order_factories API
resource type
Commerce Layer order_subscription_items API
resource type
Commerce Layer order_subscriptions API
resource type
Commerce Layer orders API
resource type
Commerce Layer organization API
resource type
Commerce Layer organizations API
resource type
Commerce Layer packages API
resource type
Commerce Layer parcel_line_items API
resource type
Commerce Layer parcels API
resource type
Commerce Layer payment_gateways API
resource type
Commerce Layer payment_methods API
resource type
Commerce Layer payment_options API
resource type
Commerce Layer paypal_gateways API
resource type
Commerce Layer paypal_payments API
resource type
Commerce Layer percentage_discount_promotions API
resource type
Commerce Layer permissions API
resource type
Commerce Layer pickups API
resource type
Commerce Layer price_frequency_tiers API
resource type
Commerce Layer price_list_schedulers API
resource type
Commerce Layer price_lists API
resource type
Commerce Layer price_tiers API
resource type
Commerce Layer price_volume_tiers API
resource type
Commerce Layer prices API
resource type
Commerce Layer promotion_rules API
resource type
Commerce Layer promotions API
resource type
Commerce Layer recurring_order_copies API
resource type
Commerce Layer refunds API
resource type
Commerce Layer reserved_stocks API
resource type
Commerce Layer resource_errors API
resource type
Commerce Layer return_line_items API
resource type
Commerce Layer returns API
resource type
Commerce Layer roles API
resource type
Commerce Layer satispay_gateways API
resource type
Commerce Layer satispay_payments API
resource type
Commerce Layer shipments API
resource type
Commerce Layer shipping_categories API
resource type
Commerce Layer shipping_method_tiers API
resource type
Commerce Layer shipping_methods API
resource type
Commerce Layer shipping_weight_tiers API
resource type
Commerce Layer shipping_zones API
resource type
Commerce Layer singleton API
singleton resource
Commerce Layer sku_list_items API
resource type
Commerce Layer sku_list_promotion_rules API
resource type
Commerce Layer sku_lists API
resource type
Commerce Layer sku_options API
resource type
Commerce Layer skus API
resource type
Commerce Layer stock_items API
resource type
Commerce Layer stock_line_items API
resource type
Commerce Layer stock_locations API
resource type
Commerce Layer stock_reservations API
resource type
Commerce Layer stock_transfers API
resource type
Commerce Layer stores API
resource type
Commerce Layer stripe_gateways API
resource type
Commerce Layer stripe_payments API
resource type
Commerce Layer stripe_tax_accounts API
resource type
Commerce Layer subscription_models API
resource type
Commerce Layer tags API
resource type
Commerce Layer talon_one_accounts API
resource type
Commerce Layer tax_calculators API
resource type
Commerce Layer tax_categories API
resource type
Commerce Layer tax_rules API
resource type
Commerce Layer taxjar_accounts API
resource type
Commerce Layer transactions API
resource type
Commerce Layer usage API
Operations with usage resource
Commerce Layer user API
The user API from Commerce Layer — 1 operation(s) for user.
Commerce Layer users API
resource type
Commerce Layer versions API
resource type
Commerce Layer vertex_accounts API
resource type
Commerce Layer voids API
resource type
Commerce Layer webhooks API
resource type
Commerce Layer wire_transfers API
resource type
Scroll within the panel for all 148 ·
Postman Collections 3
A runnable collection turns the contract into something a developer can execute in seconds. We profile them because the fastest way to trust an API is to make a real call against it.
Ready-to-run Postman collections for exercising this provider's APIs.
Open Collections 3
Open, tool-agnostic collections carry the same runnable value as Postman without locking you to one client — the portable, forkable form of the same exercise.
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Commerce Layer API
OPEN COLLECTIONCommerce Layer Metrics API
OPEN COLLECTIONCommerce Layer Provisioning API
OPEN COLLECTIONArazzo Workflows 17
Real integrations are rarely a single call. Arazzo describes the multi-step sequences — auth, then create, then confirm — so both a human and an agent can follow the choreography, not just the endpoints.
Multi-step API workflows described with the Arazzo specification.
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.
ARAZZOScroll within the panel for all 17 ·
MCP Servers 1
Model Context Protocol servers expose these APIs directly to AI agents. We profile them because agent-native access is the fastest-growing way this provider's capabilities actually get used.
Model Context Protocol servers that expose these APIs to AI agents.
MCP Server for Metrics API
MCP SERVERGraphQL 1
Where a provider ships GraphQL, the schema is the contract. We profile it alongside the REST surface so the whole interface is legible in one place.
GraphQL schemas published by this provider.
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...
GRAPHQLPricing Plans 1
Pricing is part of the interface. Machine-readable plans tell you what a tier costs and includes before you commit — one of the six things the Kin Score reads for commercial clarity.
Published pricing tiers and plan structures.
Rate Limits 1
Rate limits are the difference between a demo that works and a production integration that doesn't fall over. Publishing them is an operational-transparency signal — and a hard requirement for any agent that plans its own throughput.
Documented rate limits and quota policies.
Commerce Layer Rate Limits
RATE LIMITSFinOps 1
Cost, billing, and metering signals let a buyer model the financial operations of an API before it's live. We profile them for the same reason we profile pricing: the money is part of the contract.
Cost, billing, and metering signals for API financial operations.
Commerce Layer Finops
FINOPSFeatures 25
The notable capabilities this provider advertises, captured as structured features so they can be searched and compared instead of read one landing page at a time.
Notable capabilities this provider offers.
Scroll within the panel for all 25 ·
Semantic Vocabularies 1
JSON-LD contexts give the data shared meaning across APIs. We profile them because semantics are what let a machine reconcile 'customer' here with 'customer' somewhere else.
JSON-LD contexts and semantic vocabularies used across these APIs.
Commerce Layer Context
JSON-LDSpectral Rules 1
Governance rulesets we run against this provider's specs — the automated checks behind parts of the score. Profiling them makes the quality bar explicit and re-runnable, not a matter of opinion.
Commerce Layer API Rules
SPECTRALJSON Schema 2
Standalone JSON Schema definitions describe the data models behind the API. We profile them so the shapes are validatable on their own — useful long after a single request is forgotten.
Standalone JSON Schema definitions for this provider's data models.
Commerce Layer Order
JSON SCHEMACommerce Layer SKU
JSON SCHEMASecurity Posture 3
Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Agentic Access 1
An x-agentic-access contract marks which operations are safe for an agent to run on its own and which need a human in the loop. It is the difference between an API an agent can use and one it can use safely.
Recommended x-agentic-access execution contracts for AI agents.
Resources
Every other property we hold for Commerce Layer — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.
Get Started 5
Portal, sign-up, and the first successful call
Documentation 10
Reference material describing how the API behaves
Scroll within the panel for all 10 ·
Agent Surfaces 2
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 19
Pagination, idempotency, versioning, errors, and events
Scroll within the panel for all 19 ·
Build 41
SDKs, sample code, and the tooling you integrate with
Scroll within the panel for all 41 ·
Access & Security 5
Authentication, authorization, and security posture
Operate 5
Status, limits, changes, and where to get help
Commercial 5
Pricing, plans, and the legal terms of use
Company 2
The organization behind the API
← All providers · Data indexed from github.com/api-evangelist/commerce-layer · machine-readable index on apis.io