> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vellaro.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Vellaro API

> The API-first e-commerce engine. Build storefronts, mobile apps, and AI automations on Vellaro.

Vellaro is a **headless e-commerce engine**: you use our APIs as the backend and
freely build your own storefront, mobile app, or integrations.
Catalog, search, cart, checkout, payments, orders, accounts, content — everything
is exposed via REST, on the same infrastructure that powers the official storefronts.

<CardGroup cols={2}>
  <Card title="Build a storefront" icon="store" href="/en/guides/build-storefront">
    A complete web frontend with the Storefront API (publishable key).
  </Card>

  <Card title="Build a mobile app" icon="mobile" href="/en/guides/build-mobile">
    iOS/Android/Flutter on the same API, with the publishable key.
  </Card>

  <Card title="Manage the store via API" icon="gear" href="/en/guides/admin-api">
    Catalog, orders, customers, and more with the Admin API (staff token).
  </Card>

  <Card title="AI & MCP" icon="robot" href="/en/ai-mcp">
    Connect Vellaro to AI engines as a connector (MCP) — conversational commerce.
  </Card>
</CardGroup>

## Two API surfaces

| Surface        | For whom                              | Auth                                                           | Prefix             |
| -------------- | ------------------------------------- | -------------------------------------------------------------- | ------------------ |
| **Storefront** | frontend/mobile (client side)         | publishable key `cx_pk_...` (+ customer token for the account) | public `/api/v1/*` |
| **Admin**      | store management, ERP/AI integrations | staff token (JWT) with permissions                             | `/api/v1/admin/*`  |

The publishable key **cannot** touch the `/admin/*` endpoints: even if it leaked,
it stays limited to the store's storefront data.

## Next steps

<Steps>
  <Step title="Get a key">
    The store manager provides you with the **publishable key** (`cx_pk_live_...`).
    For the Admin API you need a **staff account** with the appropriate permissions.
  </Step>

  <Step title="First call">
    Follow the [Quickstart](/en/quickstart) and read the catalog in 30 seconds.
  </Step>

  <Step title="Build">
    Pick a [guide](/en/guides/build-storefront) and use the
    [API Reference](/en/api-reference) generated from the live OpenAPI schema.
  </Step>
</Steps>