Get a list of merchant catalogs

GET

/v1/merchantCatalog/list

Returns catalog data only (no variants included).
For account owner or regular merchant: Returns all catalogs.
For subaccount: Returns owned catalogs, assigned catalogs, or inherited catalogs from the account owner.

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

🟠400

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success

{
    "catalogs": [
        {
            "id": "63f5f1f77dabc3305f462344",
            "ownerMerchantId": "merchant123",
            "name": "Default Product Catalog",
            "description": "The default catalog containing all products for this merchant",
            "isEnabled": true,
            "assignedToSubAccountIds": []
        },
        {
            "id": "63f5f1f77dabc3305f462345",
            "ownerMerchantId": "merchant123",
            "name": "Premium Products Catalog",
            "description": "Catalog containing premium products for this merchant",
            "isEnabled": false,
            "assignedToSubAccountIds": [
                "subAccount1",
                "subAccount2"
            ]
        },
        {
            "id": "63f5f1f77dabc3305f462346",
            "ownerMerchantId": "merchant123",
            "name": "Seasonal Products Catalog",
            "description": "Catalog containing seasonal products for this merchant",
            "isEnabled": false,
            "assignedToSubAccountIds": [
                "subAccount3"
            ]
        }
    ]
}

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

Partially update a merchant catalog

Delete a merchant catalog