List available rewards

GET /rewards

Scope	redemptions:read
Customer session token	Accepted with the read scope, for the token’s own customer
Rate limit class	read (limits)
Idempotency key	Not used
MCP tool	charm_list_rewards

Enabled redemption rules with their point costs.

Response 200

Returns RewardList.

Field	Type	Description
data	array of Reward
next_cursor	string or null	Pass as cursor to fetch the next page; null on the last page. (nullable)
has_more	boolean	True when another page exists.

{
  "data": [
    {
      "id": "id",
      "type": "earn",
      "enabled": true,
      "name": "Gold",
      "points_cost": 120,
      "discount_type": "percentage",
      "discount_value": 1,
      "code_valid_days": 1,
      "title": "title",
      "title_translations": {},
      "fields": {},
      "summary": "summary"
    }
  ],
  "next_cursor": null,
  "has_more": true
}

Example

curl -X GET "https://charm.appfleece.app/api/v1/rewards" \
  -H "Authorization: Bearer chrm_live_..."

Errors

unauthorized · invalid_token · token_expired · insufficient_scope · access_required · validation_error · rate_limited

Every error body carries code, message, request_id and a doc_url pointing at the matching entry in the error catalog.