Spree Commerce
Open-source headless e-commerce framework with a REST API for managing products, variants, orders, customers, inventory, promotions, and payment processing. Spree provides two OpenAPI 3.0-documented APIs — a Store API for customer-facing operations and an Admin API for back-office management — along with a TypeScript SDK, CLI, and Next.js storefront starter.
Real signal across most facets with visible, nameable gaps — the contract exists but is thin, or the portal is good while governance and commercial terms are absent.
API Evangelist profiles Spree Commerce the way a machine reads it — 122 machine-readable artifacts across 86 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 — Spree Commerce scores 50.1/100 (developing), with a separate agent-readiness read of 53/100 (agent ready). 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.
Kin Score
How this is scored →scored 2026-07-27 · rubric v0.5
How we profile Spree Commerce
Each block below is one kind of artifact we hold for Spree Commerce. 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 86
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.
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 Allowed Origins API
CORS allowlist for storefront and admin client origins
Spree Commerce API Keys API
Secret and publishable API keys
Spree Commerce Authentication API
Admin user login, logout, token refresh, and current user profile
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 Channels API
Sales channels and product publication across channels
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.
Spree Commerce Countries API
The Countries API from Spree Commerce — 5 operation(s) for countries.
Spree Commerce Custom Fields API
Custom field definitions for products, variants, customers, and other resources
Spree Commerce Customer Groups API
Customer groups for segmenting customers (e.g. wholesale, VIP) used by pricing and promotions
Spree Commerce Customers API
Customer profiles, addresses, credit cards, and store credits
Spree Commerce Data Feeds API
The Data Feeds API from Spree Commerce — 2 operation(s) for data feeds.
Spree Commerce Digital Assets API
The Digital Assets API from Spree Commerce — 2 operation(s) for digital assets.
Spree Commerce Digital Downloads API
The Digital Downloads API from Spree Commerce — 1 operation(s) for digital downloads.
Spree Commerce Digital Links API
The Digital Links API from Spree Commerce — 3 operation(s) for digital links.
Spree Commerce Digitals API
Digital product downloads
Spree Commerce Exports API
Async CSV exports of admin resources
Spree Commerce Fulfillments API
Order fulfillments — shipments, fulfill, cancel, resume, split
Spree Commerce Gift Cards API
Gift cards and gift card batches
Spree Commerce Line Items API
The Line Items API from Spree Commerce — 2 operation(s) for line items.
Spree Commerce Markets API
Markets — geographic groupings of countries used for pricing, tax, and fulfillment rules
Spree Commerce Menu Items API
The Menu Items API from Spree Commerce — 3 operation(s) for menu items.
Spree Commerce Menus API
The Menus API from Spree Commerce — 2 operation(s) for menus.
Spree Commerce Newsletter Subscribers API
Guest and customer newsletter subscriptions (double opt-in)
Spree Commerce Option Types API
Option types and option values used to build product variants (e.g. Size, Color)
Spree Commerce Option Values API
The Option Values API from Spree Commerce — 2 operation(s) for option values.
Spree Commerce Order Status API
The Order Status API from Spree Commerce — 1 operation(s) for order status.
Spree Commerce Orders API
Orders, order items, applied gift cards, and applied store credits
Spree Commerce Payment Methods API
Configured payment providers and their available types
Spree Commerce Payments API
Order payments — list, capture, void
Spree Commerce Policies API
Store policies (return policy, privacy policy, terms of service)
Spree Commerce Post Categories API
The Post Categories API from Spree Commerce — 2 operation(s) for post categories.
Spree Commerce Posts API
The Posts API from Spree Commerce — 2 operation(s) for posts.
Spree Commerce Pricing API
Prices and price lists for currency-, market-, and customer-group-specific pricing
Spree Commerce Product Catalog API
Products and categories
Spree Commerce Products API
Products, taxons/categories, product custom field values, and bulk product operations
Spree Commerce Promotion Actions API
The Promotion Actions API from Spree Commerce — 2 operation(s) for promotion actions.
Spree Commerce Promotion Categories API
The Promotion Categories API from Spree Commerce — 2 operation(s) for promotion categories.
Spree Commerce Promotion Rules API
The Promotion Rules API from Spree Commerce — 2 operation(s) for promotion rules.
Spree Commerce Promotions API
Promotions, promotion rules, promotion actions, and coupon codes
Spree Commerce Refunds API
Order refunds
Spree Commerce Roles API
The Roles API from Spree Commerce — 2 operation(s) for roles.
Spree Commerce Settings API
Store-level settings — store profile, tags, store credit categories
Spree Commerce Shipments API
The Shipments API from Spree Commerce — 9 operation(s) for shipments.
Spree Commerce Shipping Categories API
The Shipping Categories API from Spree Commerce — 2 operation(s) for shipping categories.
Spree Commerce Shipping Methods API
The Shipping Methods API from Spree Commerce — 2 operation(s) for shipping methods.
Spree Commerce Staff API
Admin users, roles, and invitations to the store
Spree Commerce States API
The States API from Spree Commerce — 2 operation(s) for states.
Spree Commerce Stock Items API
The Stock Items API from Spree Commerce — 2 operation(s) for stock items.
Spree Commerce Stock Locations API
Warehouses and physical fulfillment locations
Spree Commerce Store Credit Categories API
The Store Credit Categories API from Spree Commerce — 2 operation(s) for store credit categories.
Spree Commerce Store Credit Types API
The Store Credit Types API from Spree Commerce — 2 operation(s) for store credit types.
Spree Commerce Store Credits API
The Store Credits API from Spree Commerce — 2 operation(s) for store credits.
Spree Commerce Stores API
The Stores API from Spree Commerce — 1 operation(s) for stores.
Spree Commerce Stripe API
The Stripe API from Spree Commerce — 4 operation(s) for stripe.
Spree Commerce Tax Categories API
The Tax Categories API from Spree Commerce — 2 operation(s) for tax categories.
Spree Commerce Tax Rates API
The Tax Rates API from Spree Commerce — 2 operation(s) for tax rates.
Spree Commerce Taxonomies API
The Taxonomies API from Spree Commerce — 2 operation(s) for taxonomies.
Spree Commerce Taxons API
The Taxons API from Spree Commerce — 5 operation(s) for taxons.
Spree Commerce Users API
The Users API from Spree Commerce — 2 operation(s) for users.
Spree Commerce Variants API
Product variants — the individual SKUs (size/color combinations) sold under a product
Spree Commerce Vendors API
The Vendors API from Spree Commerce — 10 operation(s) for vendors.
Spree Commerce Webhook Events API
The Webhook Events API from Spree Commerce — 1 operation(s) for webhook events.
Spree Commerce Webhook Subscribers API
The Webhook Subscribers API from Spree Commerce — 2 operation(s) for webhook subscribers.
Spree Commerce Webhooks API
Webhook endpoints and webhook delivery history
Spree Commerce Wished Items API
The Wished Items API from Spree Commerce — 2 operation(s) for wished items.
Spree Commerce Wishlists API
The Wishlists API from Spree Commerce — 9 operation(s) for wishlists.
Spree Commerce Wishlists / Wished Items API
The Wishlists / Wished Items API from Spree Commerce — 5 operation(s) for wishlists / wished items.
Spree Commerce Zones API
The Zones API from Spree Commerce — 2 operation(s) for zones.
Scroll within the panel for all 86 ·
Agent Skills 24
An agent skill packages the how-to for driving these APIs from an assistant — the prompts, the sequence, the guardrails — so the knowledge to use the API travels with it.
Packaged agent skills for driving this provider's APIs from an AI assistant.
spree-admin
AGENT SKILLspree-api-v3
AGENT SKILLspree-catalog
AGENT SKILLspree-checkout
AGENT SKILLspree-customization
AGENT SKILLspree-data-model
AGENT SKILLspree-decorators
AGENT SKILLspree-dependencies
AGENT SKILLspree-deployment
AGENT SKILLspree-events-webhooks
AGENT SKILLspree-extensions
AGENT SKILLspree-i18n
AGENT SKILLspree-legacy-api-v2
AGENT SKILLspree-payments
AGENT SKILLspree-performance
AGENT SKILLspree-pricing
AGENT SKILLspree-project
AGENT SKILLspree-promotions
AGENT SKILLspree-resource
AGENT SKILLspree-security
AGENT SKILLspree-shipping-fulfillment
AGENT SKILLspree-storefront
AGENT SKILLspree-testing
AGENT SKILLspree-typescript-sdk
AGENT SKILLScroll within the panel for all 24 ·
Pricing 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.
Spree Plans Pricing
PLANSRate 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.
Spree 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.
Spree Finops
FINOPSSemantic 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.
Spree Api 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.
Spree Commerce 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.
Spree Admin API Schemas
JSON SCHEMASpree Store API Schemas
JSON SCHEMAExamples 2
Real request and response payloads are what turn a spec from abstract into obvious — and they're one of the twelve things an agent needs to call an API correctly on the first try.
Example request and response payloads for these APIs.
Spree Admin Api Examples
EXAMPLESpree Store Api Examples
EXAMPLESecurity Posture 2
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 Spree Commerce — 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.
Documentation 1
Reference material describing how the API behaves
Agent Surfaces 2
MCP servers, agent skills, and machine-readable catalogs
Build 1
SDKs, sample code, and the tooling you integrate with
Access & Security 2
Authentication, authorization, and security posture
Operate 2
Status, limits, changes, and where to get help
Commercial 3
Pricing, plans, and the legal terms of use
Company 3
The organization behind the API
Other 1
Properties that don't map to a standard resource type
← All providers · Data indexed from github.com/api-evangelist/spree · machine-readable index on apis.io