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

# Quick Start

> Authenticate conceptually and call your first Join Markt public endpoint.

Make your first public Join Markt API calls without a seller session.

Every endpoint page in **Catalog**, **Checkout**, **Orders**, and **Analytics** includes an interactive **Try it** playground (cURL / JavaScript / Python) — fill params and send live requests against your base URL.

## 1. Read a catalog

Open [Get Storefront](/api/get-storefront) and click **Try it**, or:

```bash theme={null}
curl https://joinmarkt.com/api/stores/by-subdomain/acme/storefront
```

You should receive store, products, groups, feedback, categories, and stats.

## 2. Create an embed checkout session

Open [Create Embed Checkout](/api/embed-checkout) → **Try it**, or:

```bash theme={null}
curl -X POST https://joinmarkt.com/api/embed/checkout \
  -H "Content-Type: application/json" \
  -d '{"productId":"PRODUCT_CUID","variantId":"VARIANT_UUID","quantity":1,"theme":"dark"}'
```

Success:

```json theme={null}
{
  "orderId": "clxxx",
  "url": "https://markt.so/checkout/clxxx?embed=1&theme=dark"
}
```

Open the `url` in a browser or iframe.

## 3. Auth boundaries

| Call                   | Auth                          |
| ---------------------- | ----------------------------- |
| Catalog / embed create | Public                        |
| Checkout start         | Public (intended same-origin) |
| Delivery / keys        | Checkout token or staff       |
| Coupons CRUD / domains | Seller session                |

See [Authentication](/api/authentication).

## 4. Rate limits

Embed create is 30/min. Checkout start is 15/min. See [Rate limiting](/api/rate-limiting).

## 5. OpenAPI

Machine-readable spec: [`/openapi.json`](https://joinmarkt.com/openapi.json) (also in the Join Markt repo at `public/openapi.json`).

## 6. Payments

Configure gateway webhooks before testing real money. See [Incoming webhooks](/api/webhooks-overview).