Merchant categories - Join Markt Docs

All routes require:

Authorization: Bearer mk_live_<your_key>

List

GET /api/merchant/v1/stores/{storeId}/categories?page=1&limit=50

Scope: category:read

{
  "categories": [
    {
      "id": "clxyz...",
      "name": "Games",
      "description": null,
      "image": null,
      "storeId": "cm...",
      "productCount": 3,
      "createdAt": "2026-09-21T00:00:00.000Z",
      "updatedAt": "2026-09-21T00:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 1
}

Create

POST /api/merchant/v1/stores/{storeId}/categories

Scope: category:create · 201

{ "name": "Games", "description": "Digital game keys" }

Names are unique per store. storeId in the JSON body is ignored.

Get / update / delete

GET    /api/merchant/v1/stores/{storeId}/categories/{categoryId}
PATCH  /api/merchant/v1/stores/{storeId}/categories/{categoryId}
PUT    /api/merchant/v1/stores/{storeId}/categories/{categoryId}
DELETE /api/merchant/v1/stores/{storeId}/categories/{categoryId}

Scopes: category:read · category:update · category:delete DELETE fails with 400 while products still use the category — move or delete those products first. A category that belongs to another shop returns 404.