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

# API introduction

> Base URL, conventions, and how Join Markt HTTP APIs are organized.

Join Markt exposes authenticated HTTP APIs for the vendor dashboard, storefront clients, and platform admin. Most seller tooling talks to the **dashboard origin**.

## Base URL

Dashboard session routes:

```txt theme={null}
https://dash.joinmarkt.com/api
```

Merchant API (Bearer keys):

```txt theme={null}
https://dash.joinmarkt.com/api/merchant/v1
```

Storefront pages and hosted checkout are served on the store host or the marketing host. They are not under `/api/merchant/v1`.

## Response shape

Successful JSON responses usually return a payload object (sometimes wrapped). Errors return HTTP status codes with a human-readable `error` field (theme cart routes use `message`); dashboard and Merchant API errors add `success: false` and a machine-readable `code`. Always check status before parsing. See [Response format](https://docs.joinmarkt.com/api/response-format.md), [Errors](https://docs.joinmarkt.com/api/error-codes.md), and [Rate limits](https://docs.joinmarkt.com/api/rate-limiting.md).

## Versioning

Dashboard session routes use unversioned paths (`/api/dashboard/...`, `/api/orders`, etc.).

**Merchant integrations** use:

```txt theme={null}
https://dash.joinmarkt.com/api/merchant/v1
```

Authenticate those routes with `Authorization: Bearer mk_live_<secret>`. Session cookies are not accepted. The secret is the value shown once when the key is created or rotated (`mk_live_` plus the generated token).

## Related

* [Authentication](https://docs.joinmarkt.com/api-reference/authentication.md)
* [Stores](https://docs.joinmarkt.com/api-reference/stores.md)
* [Merchant products](https://docs.joinmarkt.com/api-reference/merchant-products.md)
* [Merchant categories](https://docs.joinmarkt.com/api-reference/merchant-categories.md)
* [Merchant groups](https://docs.joinmarkt.com/api-reference/merchant-groups.md)
* [Merchant coupons](https://docs.joinmarkt.com/api-reference/merchant-coupons.md)
* [Merchant orders](https://docs.joinmarkt.com/api-reference/merchant-orders.md)
* [Merchant invoices](https://docs.joinmarkt.com/api-reference/merchant-invoices.md)
* [Merchant customers](https://docs.joinmarkt.com/api-reference/merchant-customers.md)
* [Merchant store](https://docs.joinmarkt.com/api-reference/merchant-store.md)
* [Merchant webhooks](https://docs.joinmarkt.com/api-reference/merchant-webhooks.md)
* [Products](https://docs.joinmarkt.com/api/products.md)
* [Orders](https://docs.joinmarkt.com/api-reference/orders.md)
* [Plans](https://docs.joinmarkt.com/api-reference/plans.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.