List categories

Returns a list of product categories on the store. Requires the CATEGORIES_READ scope.

GET https://api.pandabase.io/v2/core/stores/{storeId}/categories/

Authentication

Requires a bearer token (sk_…) or an API key in the header Authorization.

Path parameters

storeId string required

(length 12–48)

Query parameters

page integer default: 1

(range 1–∞, defaults to 1)

limit integer default: 25

(range 1–100, defaults to 25)

search string

(length 0–128)

parentId string

(length 12–48)

featured boolean

No description.

isFavourite boolean

No description.

isArchived boolean

No description.

sortBy enum

No description.

sortOrder enum

No description.

Header parameters

idempotency-key string

(length 8–32)

Response 200

Default Response

ok enum required

(one of true)

data object required

No description.

Response 404

Default Response

ok enum required

(one of false)

error string required

No description.

Request
curl -X GET https://api.pandabase.io/v2/core/stores/:storeId/categories/
Response
{  "ok": true,  "data": {    "items": [      {        "id": "ctg_4tzcbfp2v8q1mzwxj5h0r1n",        "name": "Plans",        "slug": "plans",        "description": "Subscription plans for the platform.",        "parentId": null,        "displayOrder": 0,        "icon": null,        "metaTitle": null,        "metaDescription": null,        "showInNavigation": true,        "featured": false,        "isFavourite": false,        "isArchived": false,        "createdAt": "2026-05-01T10:00:00.000Z",        "updatedAt": "2026-05-01T10:00:00.000Z"      }    ],    "pagination": {      "page": 1,      "limit": 25,      "total": 1,      "totalPages": 1    }  }}