Rewards Catalog API

note

Full API endpoint documentation will be sourced from the codebase. The table below reflects known endpoints.

Endpoints

Method	Path	Description
GET	/v1/rewards	List all active rewards available for the customer
GET	/v1/rewards/:id	Get details for a specific reward
POST	/v1/rewards/:id/redeem	Redeem a reward for the authenticated customer
GET	/v1/customers/:id/reward_transactions	List all reward redemptions for a customer

Redemption Request

POST /v1/rewards/:id/redeem
{
  "customer_id": "cust_123",
  "quantity": 1
}

Redemption Response

On success, returns the redemption transaction including:

• transaction_id — unique identifier for the redemption
• code — the reward code assigned (if applicable)
• points_spent — points deducted from the customer's balance
• remaining_balance — customer's score_available after redemption