Get User Gamification Stats

POST

/apis/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

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Example

{
  "identifier": "email1@test.com",
  "identifier_type": "email",
  "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 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "identifier": "email1@test.com",
  "identifier_type": "email",
  "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 2026-01-27 04:07:25

Manage User Account

Bulk Import

Get User Gamification Stats

Authorization#

User gamification stats#

Request

Request Code Samples

Responses

Authorization

User gamification stats