List One User Across Fields

GET

/v1/communities/{communityId}/users/{userId}/user-field-histories

Read user-field audit rows at user scope. Results are ordered newest first by createdAt DESC, _id DESC. Pagination is optional: page defaults to 1, limit defaults to 50, maximum limit is 100, and page * limit must not exceed 10,000.

An empty result is a successful 200 with data: []. Legacy rows remain readable: action is always present but may be explicit null; nullable additive fields expose what could not be safely reconstructed.

Request

Path Params

Query Params

Header Params

Responses

🟢200OK

application/json

User field histories read successfully. Branch on the HTTP status and meta.code; do not branch on the human-readable message.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409Server Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://sgtr-api.returning.ai/v1/communities//users//user-field-histories?page=undefined&limit=undefined' \
--header 'Authorization;'

Response Example

200 - Success Example

{
    "meta": {
        "status": "success",
        "statusCode": 200,
        "code": "USER_FIELD_HISTORIES_LISTED",
        "scope": "user",
        "total": 1,
        "page": 1,
        "limit": 50,
        "hasNext": false
    },
    "message": "User field histories read successfully.",
    "data": [
        {
            "_id": "66f000000000000000000020",
            "communityID": "6502c9e514a3e564c5c09c0a",
            "userID": "66f000000000000000000021",
            "userObjectID": "66f000000000000000000021",
            "userNumericID": "3247779",
            "fieldID": "trading_volume",
            "fieldName": "Trading Volume",
            "fieldType": "numerical",
            "value": 10,
            "action": "increase",
            "storedValue": 110,
            "createdAt": "2026-07-20T10:30:00.000Z"
        }
    ]
}

Modified at 2026-07-20 18:50:42

List One Field Across Users

List One User's One Field