Get User Gamification Stats

POST

/apis/v1/users/activity/stats

This endpoint retrieves the past gamification history for a specific user, including the XP earned and in-game currency collected on a daily basis over a specified time range.

Authorization

Bearer token Required

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

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "identifier": "",
    "identifier_type": "userId",
    "days": 30
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://integration.returning.ai/apis/v1/users/activity/stats' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identifier": "",
    "identifier_type": "userId",
    "days": 30
}'

Responses

🟢200Success

application/json

Body

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 2025-08-27 07:30:42

Get User Gamification History

Bulk Import

Get User Gamification Stats

Authorization#

Request

Request Code Samples

Responses

Authorization