List One User's One Field
GET
https://sgtr-api.returning.ai/v1/communities/{communityId}/users/{userId}/user-fields/{fieldIdOrName}/histories
User Fields/User Field History
What this endpoint does
Cursor pagination
cursor=start.data.pagination.hasNextPage is true, send data.nextCursor as the next request's cursor.nextCursor is omitted when no later page exists.Quick start
Authentication
userFields permission as Authorization: Bearer <apiKey>. The authenticated principal must be allowed to read the requested community.Success response
200 returns { meta, message, data }. The nested data.pagination object contains total, currentPage, totalPages, hasNextPage, and hasPrevPage. The nested data.data array contains the history records.Errors
400 INVALID_PAGINATION — the cursor is empty, malformed, or cannot be decrypted.401 AUTHENTICATION_REQUIRED — the bearer credential is missing or invalid.403 API_KEY_PERMISSION_DENIED — the credential cannot read this community's history.404 — a user or field selected by this endpoint does not exist.500 USER_FIELD_OPERATION_FAILED — an unexpected read failure occurred.503 USER_FIELD_HISTORY_READ_NOT_READY — history reads are not enabled for the deployment.Retry safety
cursor=start if a saved cursor is rejected.Related endpoints
Request
Path Params
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://sgtr-api.returning.ai/v1/communities/6502c9e514a3e564c5c09c0a/users/member@example.com/user-fields/trading_volume/histories?cursor=start' \
--header 'Authorization: Bearer XXXXXX'Response Response Example
200 - Cursor Success Example
{
"meta": {
"status": "success",
"statusCode": 200,
"code": "USER_FIELD_HISTORIES_LISTED",
"scope": "user_field"
},
"message": "Read user field histories for specific user and user field api success.",
"data": {
"pagination": {
"total": 496805,
"currentPage": 1,
"totalPages": 2485,
"hasNextPage": true,
"hasPrevPage": false
},
"nextCursor": "U2FsdGVkX1/6+vdZcqFhnWfpnXZNtegH4eHRJKbWyyg=",
"data": [
{
"_id": "66f000000000000000000020",
"communityID": "6502c9e514a3e564c5c09c0a",
"userID": "66f000000000000000000021",
"userObjectID": "66f000000000000000000021",
"userNumericID": 3247779,
"fieldID": "66f000000000000000000010",
"fieldName": "trading_volume",
"fieldType": "numerical",
"value": 10,
"storedValue": 110,
"action": "increase",
"createdAt": "2026-09-18T10:30:00.000Z",
"updatedAt": "2026-09-18T10:30:00.000Z"
}
]
}
}Modified at 2026-09-18 05:32:17