For global context about rewards, you can read our functional documentation article .
To display granted rewards (Granted reward) of a specific contact, you can use this endpoint: List a contact’s granted rewards.
This list will give all the rewards that have been granted to this contact, including expired and burned ones.
To display some of them, for example only the available ones to burn, you can filter the API response by 'status'.
The different possibilities of reward status are:
for a valid reward, status for display = "valid" for an expired reward, status for display = "expired" for a burned reward, status for display = "burned" for a pending reward, status for display = "pending"
For error management, the status can also have this value:
"invalid earned date"