Get store product by ID

Returns one active store product from the API-key's community by product ID, with optional partner-safe field projection and translation language.

Use this when a partner integration needs product detail for a storefront product page, reward detail view, or redemption flow.

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:

productID must be a valid product identifier accepted by the source store service

fields is a comma-separated projection using partner-safe selectable product fields; productPermission and __v are not public fields

lang selects translated product fields when localized content is configured

Invalid IDs or unsupported projection fields return 400

Missing products return 404 when the source service reports not found

Upstream store-service failures return 502

Example — read:

{ "path": "/products/507f1f77bcf86cd799439031", "query": "?fields=name,price,type&lang=th" }

Related endpoints:

GET /stores — read store configuration

GET /categories — list store categories

GET /categories/{categoryID} — read a single store category

GET /products — list active store products

{ "meta": { "status": "success", "statusCode": 200 }, "message": "Read product success.", "data": { "_id": "507f1f77bcf86cd799439031", "communityID": "6502c9e514a3e564c5c09c0a", "name": "Premium Voucher", "description": "<p>Redeem for premium access.</p>", "image": "https://example.com/product.png", "price": 100, "type": "voucher", "categoryID": "650906d314a3e564c56f3450", "stocks": 45, "discountPrice": 90, "isDiscountEnabled": false, "discountStartDate": "2026-04-28T00:00:00.000Z", "discountEndDate": "2026-05-28T00:00:00.000Z", "userInformation": { "isEnabled": false }, "shouldPrioritiesExpiringVouchers": false, "shouldDisplayRemainingQuantity": true, "expiringVoucherHighlight": { "isEnabled": false }, "isArchived": false, "totalOrders": 12, "displayOrder": 0, "redemptionInstructions": "<p>Show this voucher at checkout.</p>", "i18n": { "nameTranslations": [] }, "customOptions": { "isEnabled": false }, "isProductAccessEnabled": false, "purchaseStatusOverride": { "isEnabled": false, "statusID": null }, "createdAt": "2026-04-28T00:00:00.000Z", "updatedAt": "2026-04-28T00:00:00.000Z" } }

Request

Responses