Swell website screenshot

Swell

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.

Swell publishes 31 APIs on the APIs.io network, including Account Addresses API, Account API, Account Cards API, and 28 more. Tagged areas include Commerce, Headless Commerce, API-First, B2C, and B2B.

The Swell catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Swell’s developer surface includes authentication, documentation, getting-started guide, pricing, signup flow, developer console, changelog, and 55 more developer resources.

62.8/100 strong ▼ -5.5 Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessPaidSelf serve
34 APIs 11 Features 7 Use Cases
CommerceHeadless CommerceAPI-FirstB2CB2BSubscriptionsMarketplacesWholesaleStorefrontCheckoutPaymentsCartsOrdersCatalogInternationalization

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 62.8/100 · strong
Contract Quality 16.8 / 25
Developer Ergonomics 14.3 / 20
Commercial Clarity 16.8 / 20
Operational Transparency 4.8 / 13
Governance 8.3 / 12
Discoverability 5.9 / 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-io: 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 34

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

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.

Scroll for all 34

Postman Collections 2

Ready-to-run Postman collections for exercising this provider's APIs.

Open Collections 2

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

Swell Backend API

OPEN COLLECTION

Swell Frontend API

OPEN COLLECTION

Arazzo Workflows 13

Multi-step API workflows described with the Arazzo specification.

Swell Create Cart and Apply Coupon

Create a backend cart with items and apply a coupon code to it.

ARAZZO

Swell Build Cart and Convert to Order

Create a cart, populate its items, then convert it into an order.

ARAZZO

Swell Find and Cancel Active Subscription

Locate an account's active subscription and cancel it, branching when none exists.

ARAZZO

Swell Capture and Refund Payment

Record a payment against an order, then issue a refund against that payment.

ARAZZO

Swell Create Category and Product

Create a category and then create a product assigned to that category.

ARAZZO

Swell Create and Verify Product

Create a product in the catalog and immediately retrieve it to confirm it was stored.

ARAZZO

Swell Create and Verify Subscription

Create a recurring subscription for an account and product, then read it back.

ARAZZO

Swell Find-or-Create Customer and Order

Look up a customer by email and reuse it or create it, then place an order.

ARAZZO

Swell Onboard Customer and Place Order

Create a customer account and immediately place an order for that account.

ARAZZO

Swell Storefront Validate and Apply Coupon

Validate a coupon code, then apply it to the session cart only when it is valid.

ARAZZO

Swell Storefront Add Item and Submit Order

Look up a product, add it to the session cart, then submit the cart as an order.

ARAZZO

Swell Storefront Register and Log In

Create a storefront customer account and immediately authenticate the session.

ARAZZO

Swell Storefront Adjust Cart Item Quantity

Read the session cart, then update the quantity of one of its line items.

ARAZZO

Scroll for all 13

GraphQL 1

GraphQL schemas published by this provider.

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...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Swell Io Rate Limits

0 limits

RATE LIMITS

FinOps 1

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

Features 11

Notable capabilities this provider offers.

Customizable, API-first core

Every commerce primitive — products, carts, orders, subscriptions — is exposed as a REST resource with full CRUD and rich querying.

Headless storefront

Build any storefront — Next.js, Nuxt, Astro, mobile, native — against the public-key Frontend API and Swell.js SDK.

Native subscriptions

First-class recurring billing with plans, trials, intervals, billing limits, and dunning baked into products and orders.

B2B and wholesale

Account groups, volume pricing, invoicing, and price lists for B2B and wholesale alongside D2C flows.

Marketplaces

Multi-vendor selling with split fulfillment, vendor accounts, and per-vendor reporting.

230 currencies, 170 languages

Built-in internationalization for global stores including priced currencies on higher plans.

Apps platform with edge functions

Extend the data model, events, notifications, and admin UI via the Swell Apps platform; functions run in 200+ locations with no cold start.

Custom wire protocol

Official Node and PHP libraries use a custom protocol on port 8443 for improved performance and caching versus plain HTTPS.

MongoDB-style querying

Powerful `where` filters with comparison, logical, and array operators, plus `expand`, `include`, `sort`, `search`, and field projection.

Webhooks with retries and IP allowlist

Reliable event delivery with documented retry schedule, auto-disable, and a published source-IP allowlist for inbound verification.

AI coding-agent skills

Official Claude Code plugins and AI coding-agent skills for Swell-aware development workflows.

Scroll for all 11

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Swell Io Context

57 classes · 0 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Swell API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Swell API Rules

7 rules · 3 errors 3 warnings 1 info

SPECTRAL

JSON Schema 7

Standalone JSON Schema definitions for this provider's data models.

Swell Account

21 properties

JSON SCHEMA

Swell Cart

15 properties

JSON SCHEMA

Swell Order

25 properties

JSON SCHEMA

Swell Payment

13 properties

JSON SCHEMA

Swell Product

33 properties

JSON SCHEMA

Swell Subscription

16 properties

JSON SCHEMA

Swell Webhook Subscription

7 properties

JSON SCHEMA

Scroll for all 7

JSON Structure 4

JSON Structure definitions describing this provider's data shapes.

Swell Account Structure

13 properties

JSON STRUCTURE

Swell Order Structure

19 properties

JSON STRUCTURE

Swell Product Structure

26 properties

JSON STRUCTURE

Swell Subscription Structure

13 properties

JSON STRUCTURE

Examples 6

Example request and response payloads for these APIs.

Security Posture 2

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

Swell Io Authentication

apiKey · 2 schemes

SECURITY

Swell Io Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

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

Swell Io Agentic Access

135 operations · 71 acting · 1 human-in-the-loop

135 operations · 71 acting

AGENTIC

Use Cases 7

What developers build with this provider.

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.

Scroll for all 7

Integrations 23

Pre-built integrations with other platforms and tools.

Stripe

Default card processing and tokenization for most Swell stores.

PayPal

PayPal Express, billing agreements, and subscription processing.

Braintree

Multi-currency card processing.

Authorize.net

Card processing gateway.

Amazon Pay

Fast, account-based checkout via Amazon.

Apple Pay

Mobile wallet payments.

Google Pay

Digital wallet payments.

Klarna

Buy-now-pay-later installments.

Affirm

Buy-now-pay-later financing.

Paysafecard

Prepaid voucher payments.

QuickPay

Payment service provider integration.

99Minds.io

Omnichannel gift card and loyalty programs.

Klaviyo

Email, SMS, mobile push, and web marketing automation.

Mailchimp

Email marketing and automation.

Omnisend

Email and SMS marketing platform.

Churn Buster

Subscription retention and dunning.

Oppizi

Offline marketing campaign attribution.

Algolia

Hosted product search and discovery.

Avalara

Sales-tax calculation and filing.

Contentful

Headless CMS via the official Swell Contentful app.

Builder.io

Visual page-building CMS.

Vercel

Frontend deployment and edge hosting for Swell storefronts.

Anthropic Claude

Official Claude Code plugins and AI coding-agent skills for Swell development workflows.

Scroll for all 23

Solutions 6

Packaged solutions this provider offers.

D2C Commerce

Headless storefronts for direct-to-consumer brands.

B2B Commerce

Wholesale catalogs, account groups, invoicing, and net-terms billing.

Subscriptions

Native recurring billing with flexible plans, trials, and limits.

Marketplaces

Multi-vendor selling with split fulfillment and per-vendor reporting.

Omnichannel

Serve web, native, in-store, and agent surfaces from a single commerce backend.

Enterprise

Custom-priced plans for merchants exceeding $10M annual sales with negotiated SLAs.

Resources

Get Started 6

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 16

Pagination, idempotency, versioning, errors, and events

Scroll for all 16

Build 8

SDKs, sample code, and the tooling you integrate with

Scroll for all 8

Access & Security 2

Authentication, authorization, and security posture

Operate 6

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 14

Properties that don't map to a standard resource type

Scroll for all 14

Source (apis.yml)

apis.yml Raw ↑
aid: swell-io
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · 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-io.png
name: Swell
description: 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.
url: https://raw.githubusercontent.com/api-evangelist/swell-io/refs/heads/main/apis.yml
created: '2026-05-25'
modified: '2026-05-25'
specificationVersion: '0.20'
tags:
- Commerce
- Headless Commerce
- API-First
- B2C
- B2B
- Subscriptions
- Marketplaces
- Wholesale
- Storefront
- Checkout
- Payments
- Carts
- Orders
- Catalog
- Internationalization
apis:
- aid: swell-io:swell-graphql-api
  name: Swell GraphQL API
  tags:
  - Commerce
  - GraphQL
  - Storefront
  - Experimental
  humanURL: https://developers.swell.is/frontend-api/frontend-libraries/graphql
  baseURL: https://{store-id}.swell.store/graphql/v2
  properties:
  - url: https://developers.swell.is/frontend-api/frontend-libraries/graphql
    type: Documentation
  - url: https://{store-id}.swell.store/playground
    type: APIReference
    name: GraphQL Playground
  - url: graphql/swell-io-graphql.md
    type: GraphQL
  description: 'Experimental (alpha) GraphQL endpoint that exposes a curated subset of the storefront commerce model — products,
    attributes, categories, accounts, sessions, carts, orders, payments, payment settings, subscriptions, store settings,
    currencies, and navigation menus. Authorized with a public storefront key passed in the Authorization header. Notable
    limits: no nested queries, no payment tokenization, no abandoned-cart recovery, no guest cart email updates. A GraphQL
    playground is available at /playground when logged into the dashboard.'
- aid: swell-io:swell-webhooks-api
  name: Swell Webhooks
  tags:
  - Commerce
  - Eventing
  - Webhooks
  humanURL: https://developers.swell.is/backend-api/webhooks
  properties:
  - url: https://developers.swell.is/backend-api/webhooks
    type: Documentation
  - url: examples/swell-webhook-event-example.json
    type: Examples
  description: Event-driven HTTP callbacks for cart, order, subscription, payment, account, and product lifecycle events.
    Configurable via the dashboard (Developer → Webhooks) or programmatically through the Backend API and Swell Apps. Payloads
    are JSON POSTs with `id`, `date_created`, `model`, `type`, and `data`. Endpoints must return 2xx; failed deliveries retry
    hourly for two days, continue hourly after, and auto-disable after three days. Webhooks originate from the documented
    Swell IP allowlist (52.52.111.237, 54.219.85.17, 54.241.235.166, plus 216.218.185.0/27, 216.218.244.192/27, 74.80.234.0/24).
- aid: swell-io:swell-apps-platform
  name: Swell Apps Platform
  tags:
  - Apps
  - Extensions
  - Functions
  - Edge
  humanURL: https://developers.swell.is/apps/overview
  properties:
  - url: https://developers.swell.is/apps/overview
    type: Documentation
  - url: https://github.com/swellstores/apps-sdk
    type: SDKs
    name: Swell Apps SDK
  - url: https://github.com/swellstores/app-types
    type: SDKs
    name: Swell Apps TypeScript Bindings
  description: 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+ locations with no cold start, and admin UI surfaces (settings,
    content views). Apps are distributed via a swell.json manifest and built with the Swell CLI and Apps SDK; TypeScript bindings
    are published in the app-types package. Used for first-party integrations (Contentful, Builder.io, honest reviews) and
    third-party merchant extensions.
- aid: swell-io:swell-io-account-addresses-api
  name: Swell Account Addresses API
  description: Saved shipping/billing addresses on an account.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Account Addresses
  properties:
  - type: OpenAPI
    url: openapi/swell-io-account-addresses-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-account-api
  name: Swell Account API
  description: Authenticated customer account operations.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Account
  properties:
  - type: OpenAPI
    url: openapi/swell-io-account-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-account-cards-api
  name: Swell Account Cards API
  description: Saved payment cards on an account.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Account Cards
  properties:
  - type: OpenAPI
    url: openapi/swell-io-account-cards-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-account-credits-api
  name: Swell Account Credits API
  description: Store credit balances and transactions per account.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Account Credits
  properties:
  - type: OpenAPI
    url: openapi/swell-io-account-credits-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-account-session-api
  name: Swell Account Session API
  description: Login, logout, and session recovery.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Account Session
  properties:
  - type: OpenAPI
    url: openapi/swell-io-account-session-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-accounts-api
  name: Swell Accounts API
  description: Customer accounts including billing/shipping, saved cards, and history.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Accounts
  properties:
  - type: OpenAPI
    url: openapi/swell-io-accounts-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-attributes-api
  name: Swell Attributes API
  description: Product attributes used for filtering and faceted search.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Attributes
  properties:
  - type: OpenAPI
    url: openapi/swell-io-attributes-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-cart-api
  name: Swell Cart API
  description: Session-scoped shopping cart for the current visitor.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Cart
  properties:
  - type: OpenAPI
    url: openapi/swell-io-cart-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-carts-api
  name: Swell Carts API
  description: Pending purchase requests that can be converted into orders.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Carts
  properties:
  - type: OpenAPI
    url: openapi/swell-io-carts-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-categories-api
  name: Swell Categories API
  description: Category tree and product taxonomy.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Categories
  properties:
  - type: OpenAPI
    url: openapi/swell-io-categories-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-checkout-api
  name: Swell Checkout API
  description: Cart conversion and order placement.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Checkout
  properties:
  - type: OpenAPI
    url: openapi/swell-io-checkout-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-content-api
  name: Swell Content API
  description: Pages, custom data models, and stored records.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Content
  properties:
  - type: OpenAPI
    url: openapi/swell-io-content-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-coupons-api
  name: Swell Coupons API
  description: Coupon definitions with codes, redemptions, and discount rules.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Coupons
  properties:
  - type: OpenAPI
    url: openapi/swell-io-coupons-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-events-api
  name: Swell Events API
  description: Event records emitted by the platform.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/swell-io-events-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-api/introduction
  - type: Authentication
    url: https://developers.swell.is/backend-api/authentication
  - type: APIReference
    url: https://developers.swell.is/backend-api/querying
  - type: APIReference
    url: https://developers.swell.is/backend-api/errors
  - type: JSONSchema
    url: json-schema/swell-product-schema.json
  - type: JSONSchema
    url: json-schema/swell-order-schema.json
  - type: JSONSchema
    url: json-schema/swell-cart-schema.json
  - type: JSONSchema
    url: json-schema/swell-subscription-schema.json
  - type: JSONSchema
    url: json-schema/swell-account-schema.json
  - type: JSONSchema
    url: json-schema/swell-payment-schema.json
  - type: JSONSchema
    url: json-schema/swell-webhook-schema.json
  - type: JSONStructure
    url: json-structure/swell-product-structure.json
  - type: JSONStructure
    url: json-structure/swell-order-structure.json
  - type: JSONStructure
    url: json-structure/swell-subscription-structure.json
  - type: JSONStructure
    url: json-structure/swell-account-structure.json
  - type: Examples
    url: examples/swell-product-create-example.json
  - type: Examples
    url: examples/swell-order-create-example.json
  - type: Examples
    url: examples/swell-subscription-create-example.json
  - type: Examples
    url: examples/swell-account-create-example.json
  - type: Examples
    url: examples/swell-webhook-event-example.json
  - type: Documentation
    url: https://developers.swell.is/frontend-api/introduction
  - type: Examples
    url: examples/swell-cart-add-item-example.json
- aid: swell-io:swell-io-files-api
  name: Swell Files API
  description: Stored files (images, attachments) served via Swell CDN.
  humanURL: https://developers.swell.is/backend-api/introduction
  baseURL: https://api.swell.store
  tags:
  - Files
  properties:
  - type: OpenAPI
    url: openapi/swell-io-files-api-openapi.yml
  - type: Documentation
    url: https://developers.swell.is/backend-a

# --- truncated at 32 KB (75 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/swell-io/refs/heads/main/apis.yml