Get user field histories for a specific field

GET

/v1/communities/{communityId}/user-fields/{fieldIdOrName}/histories

Retrieve all user field history records for a specific field within a community.
This endpoint returns user details for each history entry but omits field information since the field is specified in the path.

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

Path Params

Query Params

Responses

🟢200OK

application/json

Get user field histories for specific field successful

Body

🟠400Bad Request

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://sgtr-api.returning.ai/v1/communities/507f1f77bcf86cd799439011/user-fields/507f1f77bcf86cd799439013/histories?page=1&limit=10'

Response Example

200 - Success

{
    "meta": {
        "status": "success",
        "statusCode": 200,
        "total": 32,
        "page": 1,
        "limit": 10
    },
    "message": "Get user field histories",
    "data": [
        {
            "_id": "685a48f5cbfa3985ad581bae",
            "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",
            "user": {
                "_id": "507f1f77bcf86cd799439013",
                "id": 12346,
                "avatar": null,
                "displayName": "Jane Smith",
                "username": "janesmith"
            },
            "value": 250,
            "action": "increase",
            "createdAt": "2025-06-23T13:30:15.123Z"
        }
    ]
}

Modified at 2026-04-07 08:39:29

Get all user field histories in a community

Get user field histories for a specific user