Get Redemption Preference
GET/client/users/:correlation_id/redemption-preference
Returns the member's saved redemption preference for the given type and the full set of available tier options in a single call — no round-trip needed.
Path Parameters
| Param | Type | Description |
|---|---|---|
correlationId | string | Session correlation ID |
Query Parameters
| Param | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Redemption type. MVP: VOUCHER only. |
Response 200
Returns both the member's preference (if any) and the available tier options. Never returns 404 for "no preference set" — preference is {} (empty object) when no record exists.
options.tiers is the full tier map from voucherConfig.redemptionPreference.tiers. CUX uses this to render tier options — no separate config call needed.
tierLabel on the preference is resolved server-side from the tiers map (reverse lookup: thresholdPoints → label).
Errors
| Code | Error | Description |
|---|---|---|
| 404 | FEATURE_NOT_ENABLED | voucherConfig.redemptionPreference.enabled is false for this client |
Request
Responses
- 200
- 404
200 - Preference Set (SILVER tier)
404 - Feature Not Enabled