Get user field histories for a specific user
GET
/v1/communities/{communityId}/users/{userId}/user-field-histories
What this endpoint does
INFO
POST /v1/users/info for the ObjectId if you only have email → GET /v1/communities/{communityId}/users/{userId}/user-field-histories?page=1&limit=5.Quick start
Authentication and permission
Authorization: Bearer <COMMUNITY_API_KEY> with userFields.Complete examples
USER_FIELD_HISTORIES_LISTED and Read user field histories for specific user api success. An empty data array is still 200 when that member has no history rows in this window.Success and readback
200. meta.code is USER_FIELD_HISTORIES_LISTED. Rows include fieldName, action, value, storedValue, and timestamps.CHECK
data means no history for this user, not that the user is missing. Confirm the member with POST /v1/users/info.Errors and recovery
| Status | When | Recovery |
|---|---|---|
403 API_KEY_COMMUNITY_MISMATCH | Wrong community | Use the key's community ObjectId. |
401 | Missing or invalid key | Replace the key. |
404 | Unknown user | Resolve with POST /v1/users/info first. |
Retry safety
TIP
Gotchas
https://api.returning.ai as of 2026-08-19. Do not document 503 USER_FIELD_HISTORY_READ_NOT_READY as current unless a later probe sees it.Next steps
Request
Path Params
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://adss-application.returning.ai/v1/communities/507f1f77bcf86cd799439011/users/507f1f77bcf86cd799439012/user-field-histories?page=1&limit=10'Response Response Example
200 - Success
{
"meta": {
"status": "success",
"statusCode": 200,
"total": 15,
"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"
},
"value": 500,
"action": "overwrite",
"createdAt": "2025-06-24T06:43:01.078Z"
},
{
"_id": "685957701ff244c62bd2e5b5",
"field": {
"_id": "6857de260f3c24d98fd7ca90",
"field": "coins",
"name": "Community Coins",
"type": "number",
"isCustom": true,
"createdAt": "2025-06-20T11:20:45.000Z",
"updatedAt": "2025-06-20T11:20:45.000Z"
},
"value": 100,
"action": "increase",
"createdAt": "2025-06-23T13:30:15.123Z"
}
]
}Modified at 2026-08-18 17:21:05