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

# Try the Merchant API

> Send real requests to your store from the docs.

Every page in this section has a **Try it** panel. Paste your API key, fill in the fields, and press **Send**. The response shows right under the request.

> [!WARNING]
>
> **Send makes real changes.** A `POST`, `PATCH` or `DELETE` creates, edits or deletes real data in your store. Use a test store, or a key with read-only scopes, while you explore.

## Before you start

**1. Create an API key**

Open **Dashboard → Developers → API keys** and create a key. Pick the store and the scopes you need. See [API keys](https://docs.joinmarkt.com/developers/api-keys.md).

**2. Find your store ID**

Call [Get the store](https://docs.joinmarkt.com/api-playground/store/get-the-store.md), or copy the ID from the dashboard URL. Put it in the `storeId` field of every request.

**3. Paste the key**

In the **Authorization** field, paste the key that starts with `mk_live_`. The docs send it as `Authorization: Bearer mk_live_…`.

## Limits

* 120 requests per minute per key. Over the limit returns `429`.
* A missing or wrong key returns `401`. A key without the scope returns `403`.
* Every response is JSON.

The written reference for each area is in [Merchant API](https://docs.joinmarkt.com/api-reference/merchant-products.md). The machine-readable spec is [merchant-v1.json](https://dash.joinmarkt.com/openapi/merchant-v1.json).


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