Returning.AI
  1. Users
Returning.AI
  • Returning.AI
    • Auth
      • secure auth
      • register
      • verify email
      • login
    • Server
      • create new server
      • get my servers
      • update server
      • role list of server
      • channel list of server
    • Role
      • create new role
      • update role
      • delete role
      • add role to a user on a server
      • remove role from a user on a server
      • get role list of user on a server
    • Channel
      • get channels list
      • create new channel
      • update channel
      • delete channel
    • Badge
      • get badges list
      • create new badge
      • update badge
      • delete badge
      • award badge to user
      • remove badge from user
    • Integration
      • Users
        • Create New User
          POST
        • Get User Data
          POST
        • Get Users with Filters
          POST
        • Manage User account
          POST
        • Get User Gamification History
          GET
        • Get User Gamification Stats
          POST
        • Bulk Import
          POST
        • Bulk Update
          POST
      • Messages
        • Send Message
        • Reply Message
        • React Message
      • Channels
        • Get Channels List
      • User Api Key
        • Get User Api Key
        • Post User Api Key
        • Update User Api Key
        • Delete Endpoint
        • api key info
    • Application
      • Community Users
        • Get community users
        • Get user
      • User Fields
        • Get all user fields for a community
        • Get specific user field
        • Create user field
        • Update user field
        • Delete user field
      • User Field Histories
        • Get all user field histories in a community
        • Get user field histories for a specific field
        • Get user field histories for a specific user
        • Get user field histories of specific user field and user
        • Create user field history for specific user
  1. Users

Get User Gamification History

GET
/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 ********************
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://integration.returning.ai/apis/v1/users/activity/daily?identifier=admin@returning.ai&identifier_type=email&days=20'

Responses

🟢200Success
application/json
Body

Example
{
    "status": "success",
    "message": "User gamification stats fetched successfully",
    "data": {
        "user_id": "123",
        "range": {
            "start_date": "2025-07-14",
            "end_date": "2025-08-12"
        },
        "totals": {
            "coins": 12,
            "xp": 18
        },
        "daily_stats": [
            {
                "date": "2025-08-12",
                "coins": 3,
                "xp": 3
            },
            ...
            {
                "date": "2025-07-14",
                "coins": 0,
                "xp": 0
            }
        ]
    }
}
Modified at 2025-08-12 10:24:23
Previous
Manage User account
Next
Get User Gamification Stats