Get all rewards by projectId

GET 
/rewards/by/project/:projectId

Get all rewards by projectId

Request

Path Parameters

projectId projectIdrequired

The unique identifier for the project

Query Parameters

startDate date-time

Search by start date

endDate date-time

Search by end date

category string

Filter by category(e.g. manual, webhook, etc.)

page integer

Possible values: >= 1

Default value: 1

Specify the page number for pagination (default is 1).

limit integer

Default value: 10

Specify the number of projects per page (default is 10, 0 gets all results).

sortBy string

Possible values: [createdAt, requiredPoints, expiresAt, userRewardCount, rankOrder]

Field to order the results by (e.g., 'createdAt', 'requiredPoints'). Default is 'createdAt'.

sortOrder string

Possible values: [asc, desc]

Default value: desc

'asc' for ascending or 'desc' for descending order. Default is 'desc'.

Responses

200

Rewards retrieved successfully

application/json

Schema

Schema

• Array [

thumbnail urinullable

Optional URL for the reward's thumbnail image.

createdAt date-time

Time representation of entity creation

name rewardName (string)required

Possible values: <= 32 characters

Name of the reward

requiredPoints integer

Possible values: <= 1000000

Points required to claim the reward

userRewardsLimit integer

Maximum allowed number of times for the reward to be redeemed by a single user

description string

Detailed description of the reward

myUserRewardCount integer

Number of times this reward has been redeemed by the current user.

data stringnullable

Additional JSON metadata for triggers, actions or general easy-access data

rankOrder integer

The order in which the reward should be displayed

rewardTypeId rewardTypeId (string)required

Unique identifier for RewardType

userRewardCount integer

Number of times this reward has been redeemed.

maxClaims integernullable

Maximum number of times this reward can be redeemed.

id rewardId (string)

Unique identifier for Reward

projectId stringrequired

ID of the project associated with the reward

expiresAt date-timenullable

Expiration date for special rewards

• ]

Example (from schema)

[
  {
    "data": "{\"criteria\": \"win_10_strategic_games\", \"icon\": \"strategist_badge_icon.png\"}",
    "myUserRewardCount": 1,
    "description": "By devising a winning strategy, you've earned this prestigious badge.",
    "requiredPoints": null,
    "name": "Achievement Unlocked: Master Strategist",
    "createdAt": "2024-02-15T12:30:00.00Z",
    "thumbnail": "https://file.playmakers.co/rbSLt8c7w/rbSLt8c7w_thumbnail.png",
    "id": "rbSLt8c7w",
    "maxClaims": null,
    "expiresAt": "2026-02-15T12:30:00.00Z",
    "projectId": "pGdouyKfY",
    "userRewardCount": 3,
    "rewardTypeId": "RCFwQSOkf"
  },
  {
    "userRewardCount": 1,
    "rewardTypeId": "RCFwQSOkf",
    "projectId": "pGdouyKfY",
    "expiresAt": "2025-03-10T15:45:00.00Z",
    "id": "r1diPhaVh",
    "maxClaims": null,
    "thumbnail": "https://file.playmakers.co/r1diPhaVh/r1diPhaVh_thumbnail.png",
    "createdAt": "2024-03-10T15:45:00.00Z",
    "requiredPoints": null,
    "name": "Achievement Unlocked: Social Butterfly",
    "description": "You've engaged with the community by participating in 20 discussions, earning this vibrant badge.",
    "data": "{\"criteria\": \"participate_in_20_discussions\", \"icon\": \"social_butterfly_badge_icon.png\"}",
    "myUserRewardCount": 0
  }
]

403

Forbidden

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Forbidden access"
}

404

NotFound

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "A mandatory item was not found"
}

500

Internal Server Error

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Internal Server Error"
}

Loading...