Get daily user XP and coin changes
POST
/v1/users/activity/daily
What this endpoint does
INFO
POST /v1/users/activity/daily with identifier, identifier_type, and date as DD/MM/YYYY.Quick start
identifier is an array. A single string identifier is also accepted and returns the same envelope.Authentication and permission
getUserStats. Keep the key server-side.Complete examples
message is User gamification stats fetched successfully. data includes date, pagination (page, limit, total, total_pages, found), and results[] with identifier, user_id, date, coins, xp.coins / xp on that date is a real row, not a missing member.Success and readback
200. Repeat for another date to compare days. Confirm identity with POST /v1/users/info.Errors and recovery
| Status | When | Recovery |
|---|---|---|
401 | Missing or invalid token | Add a valid community key with getUserStats. |
Retry safety
TIP
Gotchas
DD/MM/YYYY.identifier as an array to match the documented schema.identifier_type is email or userId.Next steps
Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://adss-integration.returning.ai/apis/v1/users/activity/daily' \
--header 'Authorization: Bearer <COMMUNITY_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
"identifier": "client@example.com",
"identifier_type": "email",
"date": "15/08/2026"
}'Response Response Example
200 - 200 - Populated batch
{
"status": "success",
"message": "User gamification stats fetched successfully",
"data": {
"date": "15/08/2026",
"pagination": {
"page": 1,
"limit": 100,
"total": 2,
"total_pages": 1,
"found": 2
},
"results": [
{
"identifier": "client-one@example.com",
"user_id": "66b100000000000000000001",
"date": "15/08/2026",
"coins": 12.5,
"xp": 30
},
{
"identifier": "client-two@example.com",
"user_id": "66b100000000000000000002",
"date": "15/08/2026",
"coins": -4,
"xp": 10.25
}
]
}
}Modified at 2026-08-19 13:44:27