Get User Gamification Stats

POST

/v1/users/activity/stats

This endpoint returns the past gamification stats history for a specific user, providing the count of how many times user completed the action daily over a specified time range.

Authorization

Bearer token Required

Found in the platform under community settings > API keys.
Permission: Get User Stats

User gamification stats

API will return count of

Messages sent

Replies

Reactions

Social actions
(A combination of all follows, likes, comments and share of all connected social account.)

Request

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.returning.ai/v1/users/activity/stats' \
--header 'Content-Type: application/json' \
--data-raw '{
  "identifier": "email1@test.com",
  "identifier_type": "email",
  "days": 30
}'

Response Example

{
    "status": "success",
    "message": "User gamification stats fetched successfully",
    "data": {
        "user_id": "188055",
        "range": {
            "start_date": "2025-08-18",
            "end_date": "2025-08-18"
        },
        "totals": {
            "messages": 0,
            "replies": 1,
            "reaction": 0,
            "socials": 0
        },
        "daily_stats": [
            {
                "date": "2025-08-18",
                "messages": 0,
                "replies": 1,
                "reaction": 0,
                "socials": 0
            }
        ]
    }
}

Modified at 2026-04-07 08:28:37

Manage User Account

Get all mini game logs by user email

Get User Gamification Stats

Authorization#

User gamification stats#

Request

Responses

Authorization

User gamification stats