List customer earnings
Earning history of one loyalty customer: date, title, reward and points expiration.
GET https://cotlet.dev/api/v1/yotpo/customer-earnings
read
Returns the Earnings table of a customer's profile: the date, the earning title, the reward and when the points expire. visible says whether the customer sees the row; manual adjustments are hidden by default. Use it to find which campaign or order added or removed points before you adjust them.
Parameters
| Name | Type | Description |
|---|---|---|
| email string required | string | Customer email address, exactly as in Yotpo. |
| since date | date | Only earnings on or after this date. |
Request
curl "https://cotlet.dev/api/v1/yotpo/customer-earnings?email=jane%40example.com" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("yotpo", "list_customer_earnings", {"email":"jane@example.com"})const result = await cotlet.call('yotpo', 'list_customer_earnings', {"email":"jane@example.com"});cotlet call yotpo list_customer_earnings --data '{"email":"jane@example.com"}'Example response
{
"earnings": [
{
"date": "2026-10-19",
"title": "Placed an order",
"reward": "60 points",
"points_expiration": "2027-10-19",
"visible": true
},
{
"date": "2026-10-12",
"title": "Left a review",
"reward": "30 points",
"points_expiration": "2027-10-12",
"visible": true
}
]
}