Skip to main content

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

    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, claimedAt, 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

Rewards retrieved successfully

Schema

  • Array [

  • userRewardCount integer

    Number of times this reward has been redeemed.

    expiresAt date-timenullable

    Expiration date for special rewards

    name rewardName (string)required

    Possible values: <= 32 characters

    Name of the reward

    maxClaims integernullable

    Maximum number of times this reward can be redeemed.

    createdAt date-time

    Time representation of entity creation

    rewardTypeId rewardTypeId (string)required

    Unique identifier for RewardType

    description stringrequired

    Detailed description of the reward

    rankOrder integer

    The order in which the reward should be displayed

    data stringnullable

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

    requiredPoints integer

    Possible values: <= 1000000

    Points required to claim the reward

    myUserRewardCount integer

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

    projectId stringrequired

    ID of the project associated with the reward

    id rewardId (string)

    Unique identifier for Reward

    thumbnail urinullable

    Optional URL for the reward's thumbnail image.

    userRewardsLimit integer

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

  • ]

Loading...