Get user field histories of specific user field and user
GET
/v1/communities/{communityId}/users/{userId}/user-fields/{fieldIdOrName}/histories
What this endpoint does
INFO
GET /v1/communities/{communityId}/users/{userId}/user-fields/{fieldIdOrName}/histories?page=1&limit=5 → confirm action, value, and createdAt.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 and user field api success.Success and readback
200. meta.code is USER_FIELD_HISTORIES_LISTED. Use this as the readback after Update A User Field Value.CHECK
value / storedValue / action with the write you just sent.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 or field | Resolve both identifiers first. |
Retry safety
TIP
Gotchas
https://api.returning.ai as of 2026-08-19. Older default-off / 503 notes are stale for this gateway.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-fields/507f1f77bcf86cd799439013/histories?page=1&limit=10'Response Response Example
200 - Success
{
"meta": {
"status": "success",
"statusCode": 200,
"sum": 500,
"total": 8,
"page": 1,
"limit": 10
},
"message": "Get user field histories",
"data": [
{
"_id": "685a48f5cbfa3985ad581bae",
"value": 500,
"action": "overwrite",
"createdAt": "2025-06-24T06:43:01.078Z"
},
{
"_id": "685957701ff244c62bd2e5b5",
"value": 100,
"action": "increase",
"createdAt": "2025-06-23T13:30:15.123Z"
}
]
}Modified at 2026-08-18 17:21:17