Get a reward by ID
GET/reward/:rewardId
Get a reward by ID
Request
Path Parameters
The unique identifier for the reward
Responses
- 200
- 403
- 404
- 500
Reward retrieved successfully
- application/json
- Schema
- Example (from schema)
Schema
Time representation of entity creation
Maximum number of times this reward can be redeemed.
Possible values: <= 32 characters
Name of the reward
Possible values: <= 1000000
Points required to claim the reward
Detailed description of the reward
ID of the project associated with the reward
Number of times this reward has been redeemed.
Unique identifier for RewardType
The order in which the reward should be displayed
Number of times this reward has been redeemed by the current user.
Unique identifier for Reward
Optional URL for the reward's thumbnail image.
Additional JSON metadata for triggers, actions or general easy-access data
Maximum allowed number of times for the reward to be redeemed by a single user
Expiration date for special rewards
{
"createdAt": "2024-01-01T09:00:00.00Z",
"maxClaims": null,
"name": "Amazon gift card",
"requiredPoints": 10,
"description": "{\"pre\":[\"Are you sure you want to claim this reward?\"],\"short\":\"A 20$ gift card for my followers\",\"post\":[\"Your reward has been redeemed successfully!\"]}",
"projectId": "pGdouyKfY",
"userRewardCount": 1,
"rewardTypeId": "R3b19Z1n",
"rankOrder": 1,
"myUserRewardCount": 2,
"id": "r3b19Z1n",
"thumbnail": "https://file.playmakers.co/r15Y7T4sM/r15Y7T4sM_thumbnail.png",
"data": "{\"criteria\": \"complete_all_adventure_quests\", \"icon\": \"explorer_badge_icon.png\"}",
"userRewardsLimit": 3,
"expiresAt": "2025-01-01T09:00:00.00Z"
}
Forbidden
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"error": "string"
}
{
"error": "Forbidden access"
}
NotFound
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"error": "string"
}
{
"error": "A mandatory item was not found"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"error": "string"
}
{
"error": "Internal Server Error"
}