# Spoonity API Documentation > The unified developer reference for every Spoonity service API (Auth, CMS, Links, Wallet, Insights, Offers, Flags, the Prism operator BFF and the Spoonity MCP server), covering authentication, cross-service conventions and the machine-readable OpenAPI specs. Every page is available three ways at the same slug: rendered HTML at `https://prism.spoonity.com/docs/`, the raw Markdown source at `https://prism.spoonity.com/docs/.md`, and — for CMS and Links — an OpenAPI 3.1 document under `https://prism.spoonity.com/docs/openapi/`. The Markdown URLs below are the ones to fetch: they are the same content with no navigation chrome. Nothing here requires JavaScript, a session, or an API key to read; the docs are public. Endpoints are documented in a uniform shape throughout — `### METHOD /path`, then purpose, auth, parameters, a runnable curl example, a real response body, and errors — and every heading carries a stable id, so `#post-apiv1spaces` style fragments link straight into a section. ## Documentation - [Overview](https://prism.spoonity.com/docs/index.md): What Spoonity is, the service APIs that make it up, how to choose between them, and where to start. - [Conventions](https://prism.spoonity.com/docs/conventions.md): Cross-service rules: base URLs, versioning, the error envelope, pagination, rate limits, idempotency, vendor scoping and timestamps. - [Authentication](https://prism.spoonity.com/docs/authentication.md): Every auth mechanism across the platform: vendor API keys, scoped keys and their scope vocabularies, dashboard JWT sessions, OIDC service identity, and X-API-Key vs Authorization: Bearer. - [Spoonity Auth API](https://prism.spoonity.com/docs/auth.md): Passwordless consumer identity: one-time codes over SMS/WhatsApp/email, magic links, passkeys, Sign in with Apple and Google, and POS out-of-band approval. How a brand's CUSTOMERS sign in — not how your backend authenticates, which is Authentication. - [Spoonity CMS API](https://prism.spoonity.com/docs/cms.md): Content management and the public delivery API: spaces, content, blocks, targeting, experiments and event tracking. - [Spoonity Links API](https://prism.spoonity.com/docs/links.md): Short links, QR codes, campaigns and the click analytics stream. - [Spoonity Wallet API](https://prism.spoonity.com/docs/wallet.md): Apple Wallet and Google Wallet passes: programs, enrolment sessions, pass issuance and updates. - [Spoonity Insights API](https://prism.spoonity.com/docs/insights.md): Analytics queries, metrics, dimensions and the report surface behind the Insights section. - [Spoonity Offers API](https://prism.spoonity.com/docs/offers.md): The promotions engine: cart evaluation with deterministic stacking and reason codes, the redemption lifecycle, the promotion catalog and vendor policy admin API, and the POS check surface. - [Spoonity Flags API](https://prism.spoonity.com/docs/flags.md): Feature flags and experiments for brand apps: SDK keys, local evaluation through the Swift, Kotlin and React Native SDKs, server-side evaluate, definitions and targeting rules, segments, impressions, events and the change log. - [Prism BFF API](https://prism.spoonity.com/docs/prism.md): Prism's own session-authenticated API — audit log, digest preferences, saved tiles/dashboards/goals and feedback. Operator console only, not an integration surface. - [Spoonity MCP Server](https://prism.spoonity.com/docs/mcp.md): The mcp.spoonity.com Model Context Protocol server: an AI agent endpoint wrapping the loyalty platform, Links, CMS, Apex marketing automation and Insights as tools, resources and prompts. ## Specifications - [Spoonity CMS OpenAPI](https://prism.spoonity.com/docs/openapi/cms.yaml): OpenAPI 3.1 specification for the Spoonity CMS API. - [Spoonity Links OpenAPI](https://prism.spoonity.com/docs/openapi/links.yaml): OpenAPI 3.1 specification for the Spoonity Links API. - [Spoonity Auth OpenAPI](https://prism.spoonity.com/docs/openapi/auth.yaml): OpenAPI 3.1 specification for the Spoonity Auth API. - [Spoonity Offers OpenAPI](https://prism.spoonity.com/docs/openapi/offers.yaml): OpenAPI 3.1 specification for the Spoonity Offers API. - [Spoonity Flags OpenAPI](https://prism.spoonity.com/docs/openapi/flags.yaml): OpenAPI 3.1 specification for the Spoonity Flags API.