Get User Gamification History

POST

/apis/v1/users/activity/daily

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": ["user1@test.com", "user2@test.com"],
    "identifier_type": "email",
    "date": "22/12/2025",
    "page": 1,
    "limit": 50
  }

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/daily' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identifier": ["user1@test.com", "user2@test.com"],
    "identifier_type": "email",
    "date": "22/12/2025",
    "page": 1,
    "limit": 50
  }'

Responses

🟢200Success

application/json

Body

Example

{
    "status": "success",
    "message": "User gamification stats fetched successfully",
    "data": {
        "date": "20/01/2026",
        "pagination": {
            "page": 1,
            "limit": 50,
            "total": 2,
            "total_pages": 1,
            "found": 2
        },
        "results": [
            {
                "identifier": "nhlanhlambokodo03@gmail.com",
                "user_id": "61a1239cc548eb5c7ef1a64b",
                "date": "20/01/2026",
                "coins": 60,
                "xp": 60
            },
            {
                "identifier": "admin@genesiv.io",
                "user_id": "61100af5c548eb5c7ebc7819",
                "date": "20/01/2026",
                "coins": 3,
                "xp": 45
            }
        ]
    }
}

Modified at 2026-01-27 05:13:54

Get Tier Info

Get User Gamification Logs

Get User Gamification History

Authorization#

Request

Request Code Samples

Responses

Authorization