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

Community API key with userFields permission can also be used

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200OK

application/json

Get all user field histories successful

Body

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 Code Samples

Responses