Swell website screenshot

Swell

Swell is a composable headless commerce platform that gives developers and brands API-first building blocks for storefronts, subscriptions, B2B, and multi-region commerce. It exposes a server-side Backend API for managing products, orders, customers, content, and operations, plus a client-side Frontend (Storefront) API and Swell.js / Node SDKs for building custom shopping experiences on any stack.

Swell publishes 2 APIs on the APIs.io network: Orders API and Products API. Tagged areas include Commerce, Headless Commerce, Composable Commerce, Ecommerce, and Storefront.

Swell’s developer surface includes authentication, developer portal, documentation, signup flow, pricing, engineering blog, GitHub presence, and 9 more developer resources.

🌐 Visit website 📡 Source on GitHub
45.9/100 developing ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreeSelf serve⚡ Free to try
4 APIs
CommerceHeadless CommerceComposable CommerceEcommerceStorefrontSubscriptionsB2BProductsOrdersCustomers

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 45.9/100 · developing
Contract Quality 13.4 / 25
Developer Ergonomics 7.0 / 20
Commercial Clarity 14.7 / 20
Operational Transparency 3.4 / 13
Governance 0.0 / 12
Discoverability 7.4 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/swell: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 4

Individual APIs this provider publishes, each with its own machine-readable definition.

Swell Backend API

Server-side REST API for managing the full commerce model in Swell, including products, variants, stock, categories, orders, carts, payments, refunds, shipments, subscriptions, ...

Swell Frontend (Storefront) API

Client-side API and Swell.js SDK for building custom storefronts. Exposes products, categories, accounts, sessions, addresses, credit cards, carts, orders, payments, coupons, pr...

Swell Orders API

The Orders API from Swell — 2 operation(s) for orders.

Swell Products API

The Products API from Swell — 2 operation(s) for products.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Swell Backend API

OPEN COLLECTION

GraphQL 1

GraphQL schemas published by this provider.

Swell GraphQL API

Client-side API and Swell.js SDK for building custom storefronts. Exposes products, categories, accounts, sessions, addresses, credit cards, carts, orders, payments, coupons, pr...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Swell Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Swell Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Swell Finops

FINOPS

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Swell Authentication

http · 1 scheme

SECURITY

Swell Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Swell Agentic Access

10 operations · 6 acting

10 operations · 6 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

Portal
Portal
 Signup
Signup
 Login
Login

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHub
GitHub

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 1

Status, limits, changes, and where to get help

Support
Support

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 2

The organization behind the API

Website
Website
 Blog
Blog

Other 2

Properties that don't map to a standard resource type

Storefronts
Storefronts
 Apps
Apps

Source (apis.yml)

apis.yml Raw ↑ 
aid: swell
name: Swell
description: Swell is a composable headless commerce platform that gives developers and brands API-first building blocks for
  storefronts, subscriptions, B2B, and multi-region commerce. It exposes a server-side Backend API for managing products,
  orders, customers, content, and operations, plus a client-side Frontend (Storefront) API and Swell.js / Node SDKs for building
  custom shopping experiences on any stack.
type: Index
accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Free · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/swell.png
url: https://raw.githubusercontent.com/api-evangelist/swell/refs/heads/main/apis.yml
created: '2026-05-23'
modified: '2026-05-23'
specificationVersion: '0.19'
tags:
- Commerce
- Headless Commerce
- Composable Commerce
- Ecommerce
- Storefront
- Subscriptions
- B2B
- Products
- Orders
- Customers
apis:
- aid: swell:backend-api
  name: Swell Backend API
  description: Server-side REST API for managing the full commerce model in Swell, including products, variants, stock, categories,
    orders, carts, payments, refunds, shipments, subscriptions, customers, discounts, gift cards, content models, webhooks,
    and file storage. Designed for use from Node.js, PHP, or any server-side environment.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Backend API
  - REST
  - Products
  - Orders
  - Subscriptions
  - Customers
  - Webhooks
  properties:
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: SDKs
    url: https://github.com/swellstores/swell-node
  - type: SDKs
    url: https://github.com/swellstores/swell-php
- aid: swell:frontend-api
  name: Swell Frontend (Storefront) API
  description: Client-side API and Swell.js SDK for building custom storefronts. Exposes products, categories, accounts, sessions,
    addresses, credit cards, carts, orders, payments, coupons, promotions, gift cards, subscriptions, store settings, currencies,
    localization, navigation menus, and payment options. Includes a GraphQL frontend option for headless storefronts.
  humanURL: https://developers.swell.is/frontend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Frontend API
  - Storefront
  - JavaScript SDK
  - GraphQL
  - Carts
  - Checkout
  properties:
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: SDKs
    url: https://github.com/swellstores/swell-js
  - type: SDKs
    url: https://www.npmjs.com/package/swell-js
  - url: graphql/swell-graphql.md
    type: GraphQL
- aid: swell:swell-orders-api
  name: Swell Orders API
  description: The Orders API from Swell — 2 operation(s) for orders.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/swell-orders-api-openapi.yml
- aid: swell:swell-products-api
  name: Swell Products API
  description: The Products API from Swell — 2 operation(s) for products.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Products
  properties:
  - type: OpenAPI
    url: openapi/swell-products-api-openapi.yml
common:
- type: AgenticAccess
  url: agentic-access/swell-agentic-access.yml
- type: DomainSecurity
  url: security/swell-domain-security.yml
- type: Authentication
  url: authentication/swell-authentication.yml
- type: Website
  url: https://www.swell.is
- type: Portal
  url: https://developers.swell.is
- type: Documentation
  url: https://developers.swell.is
- type: Signup
  url: https://www.swell.is/signup
- type: Login
  url: https://admin.swell.store
- type: Pricing
  url: https://www.swell.is/pricing
- type: Blog
  url: https://www.swell.is/blog
- type: GitHub
  url: https://github.com/swellstores
- type: Storefronts
  url: https://www.swell.is/storefronts
- type: Apps
  url: https://www.swell.is/apps
- type: TermsOfService
  url: https://www.swell.is/terms
- type: PrivacyPolicy
  url: https://www.swell.is/privacy
- type: Support
  url: https://support.swell.is
maintainers:
- FN: Kin Lane
  email: kinlane@gmail.com