List customer earnings
Earning history of one loyalty customer: date, title, reward and points expiration.
MCP tool yotpo_read → list_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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "yotpo_read",
"arguments": {
"operation": "list_customer_earnings",
"arguments": {
"email": "jane@example.com"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"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
}
]
},
"isError": false
}