Skip to main content

​
Headless Commerce

Headless Commerce is a commerce-as-a-service platform that provides a complete REST API for building modern e-commerce experiences. Separate your storefront from your backend and build with any frontend framework.

​
Key Features

Storefront API

Public-facing API for product browsing, cart management, checkout, and order tracking. Accessible with publishable keys.

Admin API

Full management API for products, inventory, orders, customers, discounts, and more. Requires secret keys.

Webhooks

Real-time event notifications for order updates, payment completions, and inventory changes.

TypeScript SDK

Type-safe SDK with full autocompletion for seamless integration with your applications.

​
Architecture

The API follows a two-audience pattern:
  • Storefront API (/v1/storefront/*) — For customer-facing applications. Accessible with publishable keys (pk_*).
  • Admin API (/v1/admin/*) — For back-office management. Requires secret keys (sk_*).
Both APIs share the same base URL and authentication mechanism, but differ in scope and permissions.

​
Getting Started

1

Get your API keys

Sign up and obtain your test API keys from the dashboard.
2

Make your first request

List products using the Storefront API.
3

Build your storefront

Integrate cart, checkout, and order management into your frontend.