View all product categories

GET

/v1/categories

This API request allows you to send a simple GET request to pull the information for the list of product categories available in our system. Sending the GET request will return the latest product category data generated from our system.

However, if your account is a parent account with nested child accounts, when using the Merchant ID and Merchant Group ID for a specific child account, it will return all product categories with included merchant-specific overrides.

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Body

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.ordermesh.io/catalog/v1/categories?merchantId=undefined&merchantGroupId=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "categories": [
        {
            "id": "trending",
            "title": "Trending",
            "parentId": null,
            "sortIndex": 1
        },
        {
            "id": "accessories",
            "title": "Accessories",
            "parentId": null,
            "sortIndex": 2
        }
    ]
}

Modified at 2026-05-27 12:48:51

Catalog

Create a new category