Get all user field histories in a community

Retrieve all user field history records within a community with full user and field details.
This endpoint returns comprehensive information including user profiles and field metadata for each history entry.

Security Requirements:

Bearer token authentication required

Only community owners and administrators can access this endpoint

User must have either COMMUNITY_OWNER or COMMUNITY_ADMIN permissions for the specified community

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

communityId

string

required

The unique identifier of the community

Example:

507f1f77bcf86cd799439011

Match pattern:

^[0-9a-fA-F]{24}$

Query Params

page

integer

required

Page number for pagination

>= 1

Example:

limit

integer

required

Number of items per page

>= 1<= 100

Example:

Responses

🟢200OK

application/json

Get all user field histories successful

Body

meta

object

optional

status

string

optional

statusCode

number

optional

total

number

optional

Total number of records

page

number

optional

Current page number

limit

number

optional

Number of items per page

message

string

optional

Success message for the operation

data

array [object {6}]

optional

_id

string

optional

User field history unique identifier

field

object

optional

user

object

optional

value

optional

The field value of the change (can be any type)

action

enum<string>

optional

Type of action performed on the field

Allowed values:

increasedecreaseoverwrite

createdAt

string <date-time>

optional

When this history entry was created

Example

{
    "meta": {
        "status": "success",
        "statusCode": 200,
        "total": 125,
        "page": 1,
        "limit": 10
    },
    "message": "Get user field histories",
    "data": [
        {
            "_id": "685a48f5cbfa3985ad581bae",
            "field": {
                "_id": "6857de260f3c24d98fd7ca89",
                "field": "hello",
                "name": "Hello",
                "type": "numerical",
                "isCustom": true,
                "createdAt": "2025-06-22T10:42:32.844Z",
                "updatedAt": "2025-06-22T10:42:32.844Z"
            },
            "user": {
                "_id": "61100af5c548eb5c7ebc7819",
                "id": 1,
                "avatar": "https://returning.ai/admin.png",
                "displayName": "Admin",
                "username": "admin"
            },
            "value": 500,
            "action": "overwrite",
            "createdAt": "2025-06-24T06:43:01.078Z"
        },
        {
            "_id": "685957701ff244c62bd2e5b5",
            "field": {
                "_id": "6857de260f3c24d98fd7ca90",
                "field": "xp",
                "name": "Experience Points",
                "type": "number",
                "isCustom": true,
                "createdAt": "2025-06-20T11:20:45.000Z",
                "updatedAt": "2025-06-20T11:20:45.000Z"
            },
            "user": {
                "_id": "507f1f77bcf86cd799439013",
                "id": 12346,
                "avatar": null,
                "displayName": "Jane Smith",
                "username": "janesmith"
            },
            "value": 50,
            "action": "increase",
            "createdAt": "2025-06-23T13:30:15.123Z"
        }
    ]
}

🟠400Bad Request

🟠404Record Not Found

🔴500Server Error

Get all user field histories in a community

Request

Request samples

Responses