Get store category by ID

Returns one store category from the API-key's community by category ID, with optional field projection.

Use this when a partner integration needs category detail for a storefront category page, breadcrumb, or category-specific product listing.

Authentication:

Bearer API key in Authorization header

API key must have the store permission

Community is resolved from the API key token — do not pass communityID

Returns 401 if the key is missing, invalid, or expired

Returns 403 if the key does not include the store permission

Rate limits:

Standard API rate limits apply

Constraints:

categoryID must be a valid category identifier accepted by the source store service

fields is a comma-separated projection using selectable category fields

Invalid IDs or unsupported projection fields return 400

Missing categories return 404 when the source service reports not found

Upstream store-service failures return 502

Example — read:

{ "path": "/categories/507f1f77bcf86cd799439021", "query": "?fields=name,displayOrder" }

Related endpoints:

GET /stores — read store configuration

GET /categories — list store categories

GET /products — list active store products

GET /products/{productID} — read a single store product

{ "meta": { "status": "success", "statusCode": 200 }, "message": "Read category success.", "data": { "_id": "507f1f77bcf86cd799439021", "communityID": "6502c9e514a3e564c5c09c0a", "name": "Premium Rewards", "coverImage": "https://example.com/category.png", "shouldShowCover": true, "isArchived": false, "viewType": "full", "displayOrder": 0, "categoryPermission": [], "defaultPurchaseStatusID": "650906d314a3e564c56f3450", "createdAt": "2026-04-28T00:00:00.000Z", "updatedAt": "2026-04-28T00:00:00.000Z" } }

Request

Responses