# Swell

**Canonical:** https://apis.io/providers/swell-io/  
**Website:** https://www.swell.is/  
**APIs profiled:** 34

Swell is a customizable, API-first headless commerce platform powering modern B2C, B2B, subscription, and marketplace experiences. It exposes a server-side Backend API for managing the full commerce data model (products, variants, carts, orders, payments, refunds, shipments, returns, subscriptions, accounts, invoices, coupons, promotions, gift cards, content, files, events, webhooks) plus a public-key client-side Frontend API for storefronts and an experimental GraphQL endpoint. The platform ships official Node and PHP libraries, a universal JavaScript SDK (Swell.js), headless storefront starters for Next.js (Horizon, verswell-commerce, nextjs-commerce) and Nuxt (Origin), a Swell Apps platform with CLI and Apps SDK for extending the data and logic layers via custom data models, events, notifications, webhooks, and edge functions running in 200+ locations, plus AI coding-agent skills and Claude Code plugins.

## Kin Score — 65.8 / 100 (strong)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (-1.0 from 66.8).

| Facet | Score |
|---|---|
| Discoverability | 50.0 |
| Contract Quality | 67.0 |
| Governance | 25.0 |
| Contract Governance | 25.0 |
| Operational Transparency | 57.9 |
| Developer Ergonomics | 78.6 |
| Commercial Clarity | 84.2 |
| Access Clarity | 84.2 |

Regulatory layer — **Payments**: 39.1 (matched via tags).

## Agent readiness — 31.1 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | documented |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | no |
| OpenAPI Examples | no |
| 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

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

## APIs (34)

- **Swell GraphQL API** — Experimental (alpha) GraphQL endpoint that exposes a curated subset of the storefront commerce model — products, attributes, categories, accounts, sessions, carts, orders, payme...
- **Swell Webhooks** — Event-driven HTTP callbacks for cart, order, subscription, payment, account, and product lifecycle events. Configurable via the dashboard (Developer → Webhooks) or programmatica...
- **Swell Apps Platform** — Swell Apps extend the platform with custom data models (added fields or new entities), events (triggering functions, webhooks, and notifications), edge functions deployed to 200...
- **Swell Account Addresses API** — Saved shipping/billing addresses on an account.
- **Swell Account API** — Authenticated customer account operations.
- **Swell Account Cards API** — Saved payment cards on an account.
- **Swell Account Credits API** — Store credit balances and transactions per account.
- **Swell Account Session API** — Login, logout, and session recovery.
- **Swell Accounts API** — Customer accounts including billing/shipping, saved cards, and history.
- **Swell Attributes API** — Product attributes used for filtering and faceted search.
- **Swell Cart API** — Session-scoped shopping cart for the current visitor.
- **Swell Carts API** — Pending purchase requests that can be converted into orders.
- **Swell Categories API** — Category tree and product taxonomy.
- **Swell Checkout API** — Cart conversion and order placement.
- **Swell Content API** — Pages, custom data models, and stored records.
- **Swell Coupons API** — Coupon definitions with codes, redemptions, and discount rules.
- **Swell Events API** — Event records emitted by the platform.
- **Swell Files API** — Stored files (images, attachments) served via Swell CDN.
- **Swell Gift Cards API** — Gift cards, debit transactions, and gift card products.
- **Swell Invoices API** — Invoices generated for subscription billing cycles and B2B orders.
- **Swell Orders API** — Customer orders, line items, financial totals, and lifecycle.
- **Swell Payments API** — Payment transactions, refunds, and gateway settlement.
- **Swell Products API** — Product catalog including variants, options, bundles, gift cards, and subscription products.
- **Swell Promotions API** — Automatic promotion rules applied at cart and checkout.
- **Swell Purchase Links API** — Shareable purchase links that prefill a cart.
- **Swell Refunds API** — Refund records linked to a payment.
- **Swell Returns API** — Customer return merchandise authorizations.
- **Swell Shipments API** — Fulfillment shipments, tracking, and split fulfillment.
- **Swell Stock API** — Stock levels and stock adjustments across locations.
- **Swell Store API** — Public store settings, currencies, payment settings, and menus.
- **Swell Subscription Plans API** — Plan templates that define billing schedule and price for recurring products.
- **Swell Subscriptions API** — Recurring billing subscriptions and plans.
- **Swell Variants API** — Variant-level inventory and pricing under a parent product.
- **Swell Webhooks API** — Webhook subscriptions for receiving event callbacks.

## Agentic access (1)

- **Swell Io Agentic Access** — 135 operations · 71 acting · 1 human-in-the-loop

## Security (2)

- **Swell Io Authentication** — apiKey · 2 schemes
- **Swell Io Domain Security** — TLSv1.3 · HSTS · DMARC

## Plans (1)

- **Swell Io Plans Pricing**

## Use cases (7)

- **Direct-to-consumer brands** — Power D2C storefronts with full control over product, cart, checkout, and payment UX.
- **Subscription commerce** — Box-of-the-month, SaaS-style, replenishment, and membership models with native subscription billing.
- **B2B and wholesale** — Account-group pricing, invoicing, net terms, and bulk ordering for wholesale channels.
- **Multi-vendor marketplaces** — Operate marketplaces with vendor onboarding, split fulfillment, and per-vendor payouts.
- **Headless omnichannel** — Serve web, native mobile, in-store, and AI-agent surfaces from a single commerce backend.
- **AI-driven commerce** — Back conversational commerce agents and AI shopping assistants with a clean, query-rich API.
- **Composable enterprise commerce** — Combine Swell with best-of-breed CMS, search, payments, ERP, and analytics for enterprise stacks.

## Tags

Commerce, Headless Commerce, API-First, B2C, B2B, Subscription, Marketplaces, Wholesale, Storefront, Checkout, Payments, Cart, Order, Catalog, Internationalization

---

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