Skip to content
RewardOSRewardOS Docs

Brands

Once authenticated, explore the brand catalog. RewardOS offers gift card and reward brands across categories such as Food, Fashion, Electronics, Travel, and more.

The Brand Object

Section titled “The Brand Object”
Field Type Description
id string Unique identifier for the brand / product
status string ACTIVE or INACTIVE
title string Display name
brandDescription string | null Description
category string[] Categories
tags string[] Tags
denominationType string FIXED or FLEXIBLE
thumbnailUrl string Brand thumbnail image URL
iconImageUrl string Legacy icon URL (deprecated; prefer thumbnailUrl)
amountRestrictions object Min/max order and voucher amounts, denominations
redemptionType string OFFLINE, ONLINE, or ONLINE_AND_OFFLINE

Status Handling

Section titled “Status Handling”
Status Meaning What You Should Do
ACTIVE Vouchers can be generated Safe to display and accept orders
INACTIVE Vouchers cannot be generated Remove from user-facing catalog immediately

Brand Errors

Section titled “Brand Errors”
Code Error What To Do
E100 Brand temporarily disabled Provider failure. Wait and retry later.
E101 Brand not enabled for you Contact RewardOS support to enable this brand.
E102 Brand not active Brand is INACTIVE. Do not display to users.

Denomination Types

Section titled “Denomination Types”
Type How It Works Validation
FIXED Only values in amountRestrictions.denominations Order denomination must match exactly
FLEXIBLE Any amount between min and max voucher amount Stay within min/max bounds

List Brands

Section titled “List Brands”

GET /v1/partners/products

Optional query parameters may include pagination and filters (e.g. category / search) depending on your contract.

Terminal window
curl -X GET "https://api.staging.rewardos.in/v1/partners/products?pageNo=1&limit=20" \
  -H "Authorization: Bearer <token>" \
  -H "X-REQUEST-ID: $(uuidgen)"

Get a Brand

Section titled “Get a Brand”

GET /v1/partners/products/:productId

Terminal window
curl -X GET "https://api.staging.rewardos.in/v1/partners/products/PRODUCT_ID" \
  -H "Authorization: Bearer <token>" \
  -H "X-REQUEST-ID: $(uuidgen)"

Integration Tips

Section titled “Integration Tips”
  • Cache the catalog and refresh on Brand Updated webhooks.
  • Never offer INACTIVE brands at checkout.
  • Validate denominations against the brand object before calling Place Order.