cURL
curl -X GET "https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/categories" \
-H "Authorization: Bearer $JOIN_MARKT_API_KEY"const res = await fetch("https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/categories", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.JOIN_MARKT_API_KEY}`,
},
})
const data = await res.json()import os, requests
res = requests.get(
"https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/categories",
headers={"Authorization": f"Bearer {os.environ['JOIN_MARKT_API_KEY']}"},
)
data = res.json(){
"categories": [
{
"id": "cmvuo0akj0004vdesyct47ira",
"name": "Store Themes",
"description": "Complete themes for online stores.",
"image": "https://cdn.joinmarkt.com/stores/cmvuo0akc0002vdesum2w5xa1/bade/category-store-themes.webp",
"storeId": "cmvuo0akc0002vdesum2w5xa1",
"productCount": 3,
"createdAt": "2026-10-30T07:42:52.292Z",
"updatedAt": "2026-10-30T08:54:14.062Z"
},
{
"id": "cmvuo0akp0006vdes69ewoycj",
"name": "Website Templates",
"description": "Templates for landing pages, portfolios and agencies.",
"image": "https://cdn.joinmarkt.com/stores/cmvuo0akc0002vdesum2w5xa1/bade/category-website-templates.webp",
"storeId": "cmvuo0akc0002vdesum2w5xa1",
"productCount": 3,
"createdAt": "2026-10-30T07:42:52.297Z",
"updatedAt": "2026-10-30T08:54:14.065Z"
}
],
"page": 1,
"limit": 2,
"total": 4
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}List categories
All categories, in the order shown on the storefront.
Scope: category:read
GET
/
api
/
merchant
/
v1
/
stores
/
{storeId}
/
categories
cURL
curl -X GET "https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/categories" \
-H "Authorization: Bearer $JOIN_MARKT_API_KEY"const res = await fetch("https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/categories", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.JOIN_MARKT_API_KEY}`,
},
})
const data = await res.json()import os, requests
res = requests.get(
"https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/categories",
headers={"Authorization": f"Bearer {os.environ['JOIN_MARKT_API_KEY']}"},
)
data = res.json(){
"categories": [
{
"id": "cmvuo0akj0004vdesyct47ira",
"name": "Store Themes",
"description": "Complete themes for online stores.",
"image": "https://cdn.joinmarkt.com/stores/cmvuo0akc0002vdesum2w5xa1/bade/category-store-themes.webp",
"storeId": "cmvuo0akc0002vdesum2w5xa1",
"productCount": 3,
"createdAt": "2026-10-30T07:42:52.292Z",
"updatedAt": "2026-10-30T08:54:14.062Z"
},
{
"id": "cmvuo0akp0006vdes69ewoycj",
"name": "Website Templates",
"description": "Templates for landing pages, portfolios and agencies.",
"image": "https://cdn.joinmarkt.com/stores/cmvuo0akc0002vdesum2w5xa1/bade/category-website-templates.webp",
"storeId": "cmvuo0akc0002vdesum2w5xa1",
"productCount": 3,
"createdAt": "2026-10-30T07:42:52.297Z",
"updatedAt": "2026-10-30T08:54:14.065Z"
}
],
"page": 1,
"limit": 2,
"total": 4
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}Authorizations
Your Merchant API key. Create one in Dashboard → Developers → API keys.
Path Parameters
Your store id. Find it in Dashboard → Developers, or in GET /stores with MCP.
Query Parameters
Page number, starting at 1.
Required range:
x >= 1Items per page (1–100).
Required range:
1 <= x <= 100Response
A page of categories.
The response is of type object.

