Lists
Get Field Value Changes on a List Entry
Paginate through the historical value changes on the fields of a List Entry.
For an overview of field value changes, including which fields support change tracking and how the action types behave, see Field Value Changes.
Each change includes who made the change, when it occurred, the action that was performed, and the value that was set. Changes are sorted by changedAt in ascending order (oldest first).
You can filter field value changes using the filter query parameter. The filter parameter is a string that you can specify conditions based on the following properties.
| Property Name | Type | Description | Allowed Operators | Examples |
|---|---|---|---|---|
| field.id | text | = | field.id=field-1234 | |
| changedAt | datetime | When the change was made. | >, <, >=, <= | changedAt>2026-01-01T00:00:00Z |
| changer.id | int64 | The person who made the change. | = | changer.id=1234 |
| actionType | text | The type of change (add, update, delete) | = | actionType=add |
get/v2/lists/{listId}/list-entries/{listEntryId}/field-value-changes
Path parameters
listIdinteger required
List ID
listEntryIdinteger required
List Entry ID
Query parameters
filterstring
Filter options
cursorstring
Example:ICAgICAgYmVmb3JlOjo6Nw
Cursor for the next or previous page
limitinteger
Example:10
Number of items to include in the page
Response
OK
Example response
{
"data": [
{
"id": 42,
"field": {
"id": "field-1234",
"entityType": "company",
"name": "Stage",
"type": "global"
},
"entity": {
"id": 1
},
"listEntry": {
"id": 1,
"listId": 1
},
"changer": {
"id": 1,
"firstName": "John",
"lastName": "Smith",
"emailAddress": "john.smith@contoso.com"
},
"changedAt": "2024-06-01T12:00:00Z",
"actionType": "update"
}
],
"pagination": {
"prevUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgYmVmb3JlOjo6Nw",
"nextUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgIGFmdGVyOjo6NA"
}
}