Get user field histories for a specific field
GET
/v1/communities/{communityId}/user-fields/{fieldIdOrName}/histories
What this endpoint does
INFO
GET /v1/communities/{communityId}/user-fields/{fieldIdOrName}/histories?page=1&limit=5 → paginate while meta.hasNext is true.Quick start
fieldIdOrName can be the field Mongo ObjectId or its name. On 2026-08-19 Codex, both the name and the id returned 200.Authentication and permission
Authorization: Bearer <COMMUNITY_API_KEY> with userFields. Wrong community ObjectId returns 403 API_KEY_COMMUNITY_MISMATCH.Complete examples
page=1&limit=5 returned USER_FIELD_HISTORIES_LISTED and Read user field histories for specific user field api success.Success and readback
200. meta.code is USER_FIELD_HISTORIES_LISTED. data is an array of history rows with userObjectID, fieldName, value, storedValue, action, and timestamps.CHECK
fieldName / fieldID to the definition you queried. Empty data means no mutations for that field in this window.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 field | List definitions first. |
Retry safety
TIP
403 without changing communityId.Gotchas
https://api.returning.ai as of 2026-08-19. Older 503 USER_FIELD_HISTORY_READ_NOT_READY 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/user-fields/507f1f77bcf86cd799439013/histories?page=1&limit=10'Response 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-08-18 17:20:53