Quick Start

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 and click Try it, or:

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 → Try it, or:

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:

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

4. Rate limits

Embed create is 30/min. Checkout start is 15/min. See Rate limiting.

5. OpenAPI

Machine-readable spec: /openapi.json (also in the Join Markt repo at public/openapi.json).

6. Payments

Configure gateway webhooks before testing real money. See Incoming webhooks.

⌘I

API Documentation

Reference

Analytics

Catalog

Checkout

Orders

Webhooks

Dashboard APIs

1. Read a catalog

2. Create an embed checkout session

3. Auth boundaries

4. Rate limits

5. OpenAPI

6. Payments

​1. Read a catalog

​2. Create an embed checkout session

​3. Auth boundaries

​4. Rate limits

​5. OpenAPI

​6. Payments

1. Read a catalog

2. Create an embed checkout session

3. Auth boundaries

4. Rate limits

5. OpenAPI

6. Payments