# Spree Commerce

**Canonical:** https://apis.io/providers/spree-commerce/  
**Website:** https://spreecommerce.org/  
**APIs profiled:** 97

Spree Commerce is an open-source headless eCommerce platform originally released in 2007 and built on Ruby on Rails. The Spree server exposes a modern Store API (v3), an Admin API (v3), a Platform API (v2) used by internal/back-office integrations, and a Storefront API (v2) based on the JSON:API spec - all described with OpenAPI 3 - plus an OAuth 2.0 token endpoint for authentication. Developer surface includes the TypeScript Store and Admin SDKs (@spree/sdk and @spree/admin-sdk), the @spree/cli for managing Spree projects, the create-spree-app scaffolder, the open-source Next.js storefront, the spree-starter application template, the spree_extension generator for building Rails extensions, the deface view-customization plugin, official payments integrations (Stripe, Adyen, PayPal), marketing integrations (Klaviyo, Google Analytics), an Avalara/AvaTax extension, the spree_multi_vendor marketplace extension, and a Webhook event system for reacting to store events.

## Kin Score — 38.1 / 100 (thin)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 38.1).

| Facet | Score |
|---|---|
| Discoverability | 68.5 |
| Contract Quality | 60.1 |
| Governance | 0.0 |
| Contract Governance | 0.0 |
| Operational Transparency | 42.1 |
| Developer Ergonomics | 14.3 |
| Commercial Clarity | 39.5 |
| Access Clarity | 39.5 |

## Agent readiness — 54.7 (agent-native)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | verified |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | verified |
| Error Semantics | verified |
| OpenAPI Examples | verified |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (97)

- **Spree Webhooks** — Outbound webhook event system - the Spree server emits signed JSON payloads for order, product, customer, payment, and shipment lifecycle events. The webhook envelope carries an...
- **@spree/sdk (TypeScript Store API SDK)** — Official TypeScript SDK for the Spree Store API - typed clients, auth helpers, and resource methods. Distributed via npm as @spree/sdk and consumed by the Next.js storefront, cu...
- **@spree/admin-sdk (TypeScript Admin API SDK)** — Official TypeScript SDK for the Spree Admin API. Provides a typed client for managing products, orders, customers, and store configuration from Node.js services and admin tools.
- **@spree/cli** — Command-line tool for managing Spree Commerce projects - scaffolding new apps, running the dev server, managing Docker, and orchestrating common project tasks. Installed via npm...
- **create-spree-app** — One-line project generator for new Spree Commerce installations - mirrors create-next-app and create-medusa-app patterns. Bootstraps a working Rails-based Spree project from the...
- **Spree Next.js Storefront** — Open-source Next.js storefront talking to the Spree Storefront API - cart, checkout, account, multi-region, one-page checkout, and Stripe, Adyen, and PayPal payments. MIT licensed.
- **Spree Rails Storefront** — Spree 5 storefront built with Ruby on Rails and a visual page builder. Reference implementation for teams that want a Rails-monolith storefront on top of Spree rather than a sep...
- **spree-starter (Application Template)** — Reference Spree application template used to bootstrap new Spree installations - includes Docker Compose, the recommended gem set, and a sensible default configuration for self-...
- **spree-multi-store** — Extension for running and administering multiple stores from a single Spree installation - per-store products, taxonomies, domains, and configuration.
- **Spree Stripe Integration** — Official Stripe payments integration for Spree, including support for Stripe Connect. Wires Spree's payment lifecycle to Stripe Payment Intents and Webhooks.
- **Spree Adyen Integration** — Official Adyen payments platform integration for Spree Commerce - payment methods, capture, refund, and webhook handling against the Adyen API.
- **Spree PayPal Checkout Integration** — Official PayPal Checkout integration extension for Spree - PayPal buttons, order flow, capture, and refund.
- **Spree Avalara AvaTax Integration** — Officially certified Avalara AvaTax tax-calculation integration for Spree - real-time tax calculation, address validation, and document filing against AvaTax.
- **Spree Klaviyo Integration** — Official Klaviyo marketing-platform integration for Spree - syncs customers, orders, and product events to Klaviyo for email and SMS lifecycle marketing.
- **Spree Google Analytics 4 Integration** — Official Google Analytics 4 integration for Spree - ecommerce event tracking and measurement on top of the Spree storefronts.
- **spree_extension (Extension Generator CLI)** — CLI tool for generating and managing Spree Commerce extensions - scaffolds the gemspec, engine, migrations, and conventions used by the Spree extension ecosystem.
- **Spree Dev Tools** — Internal developer tooling for working on Spree itself - debuggers, profilers, dummy data generators, and helpers used by Spree's core contributors and extension authors.
- **deface (Rails View Customization)** — Rails plugin maintained under the Spree organization that lets Spree stores customize ERB views without forking the underlying templates. Core extension primitive in the Spree e...
- **Spree Core Repository (spree/spree)** — Monorepo with the Spree Rails engine, Admin, Store/Admin/Platform/ Storefront APIs, OpenAPI specs, TypeScript SDKs, CLI, and Next.js storefront. Released since 2007; latest stab...
- **Spree Commerce Account / Address API** — The Account / Address API from Spree Commerce — 2 operation(s) for account / address.
- **Spree Commerce Account API** — The Account API from Spree Commerce — 1 operation(s) for account.
- **Spree Commerce Account / Credit Cards API** — The Account / Credit Cards API from Spree Commerce — 3 operation(s) for account / credit cards.
- **Spree Commerce Account / Orders API** — The Account / Orders API from Spree Commerce — 2 operation(s) for account / orders.
- **Spree Commerce Addresses API** — The Addresses API from Spree Commerce — 2 operation(s) for addresses.
- **Spree Commerce Adjustments API** — The Adjustments API from Spree Commerce — 2 operation(s) for adjustments.
- **Spree Commerce Adyen API** — The Adyen API from Spree Commerce — 3 operation(s) for adyen.
- **Spree Commerce Authentication API** — Admin user authentication
- **Spree Commerce Cart API** — The Cart API from Spree Commerce — 1 operation(s) for cart.
- **Spree Commerce Cart / Coupons API** — The Cart / Coupons API from Spree Commerce — 3 operation(s) for cart / coupons.
- **Spree Commerce Cart / Line Items API** — The Cart / Line Items API from Spree Commerce — 3 operation(s) for cart / line items.
- **Spree Commerce Cart / Other API** — The Cart / Other API from Spree Commerce — 4 operation(s) for cart / other.
- **Spree Commerce Carts API** — Shopping cart management
- **Spree Commerce Checkout API** — The Checkout API from Spree Commerce — 2 operation(s) for checkout.
- **Spree Commerce Checkout / Payments API** — The Checkout / Payments API from Spree Commerce — 2 operation(s) for checkout / payments.
- **Spree Commerce Checkout / Shipments API** — The Checkout / Shipments API from Spree Commerce — 2 operation(s) for checkout / shipments.
- **Spree Commerce Checkout / State API** — The Checkout / State API from Spree Commerce — 3 operation(s) for checkout / state.
- **Spree Commerce Checkout / Store Credit API** — The Checkout / Store Credit API from Spree Commerce — 2 operation(s) for checkout / store credit.
- **Spree Commerce Classifications API** — The Classifications API from Spree Commerce — 2 operation(s) for classifications.
- **Spree Commerce CMS Pages API** — The CMS Pages API from Spree Commerce — 2 operation(s) for cms pages.
- **Spree Commerce CMS Sections API** — The CMS Sections API from Spree Commerce — 2 operation(s) for cms sections.
- …and 57 more, listed in full on the page.

## Agentic access (1)

- **Spree Commerce Agentic Access** — 524 operations · 311 acting · 5 human-in-the-loop

## Security (2)

- **Spree Commerce Authentication** — apiKey/http · 3 schemes
- **Spree Commerce Domain Security** — TLSv1.3 · HSTS

## Plans (1)

- **Spree Commerce Plans Pricing**

## Tags

Commerce, Headless, E-Commerce, Open-Source, Ruby on Rails, Ruby, TypeScript

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/spree-commerce/). Scores are computed from the provider's own public artifacts under a published rubric.