Core resources

Rewards

5min

The rewards summary object describes the pending, available, and earned cashback for a user. These cashback rewards depend on the offers linked to the transactions of the user.

The table below outlines the available API call and action for rewards.

Action

API call

Description

GET /rewards/summary/{publisher_user_id}

Retrieves the summary of a specified user's rewards.



GET /rewards/summary/{publisher_user_id}

Retrieves the summary of a specified user's rewards.

Path parameters



Name

Data type

Description

{publisher_user_id} REQUIRED

string

Unique identifier for the user sent by the publisher, to identify a user in the publisher’s system.

Responses



HTTP status 200

Returns an array of rewards summary object with a 200 response code, if successful. For more information, see Status and response codes.



Body

Name

Data type

Description

available_cashback

number

The amount of cashback rewards that are ready to be redeemed. This value is based on submitted transactions for the user in the system.

pending_cashback

number

The amount of cashback rewards that are not yet available to be redeemed. This value is based on the pending transactions for the user in the system.

total_earned_cashback

number

The total lifetime cashback earned by the user.