--- title: "Get all field value changes" method: GET path: "/v2/field-value-changes" tags: ["Field Value Changes"] --- # Get all field value changes `GET /v2/field-value-changes` Retrieve field value changes across all entities and fields in your Affinity workspace. For an overview of field value changes, including which fields support change tracking and how the action types behave, see [Field Value Changes](/pages/data-model/working-with-field-data#field-value-changes). This endpoint is built for delta-sync. Within a single sync, follow `pagination.nextUrl` to page through results until it becomes `null`, which means you have reached the most recent change. To run the next incremental sync, record the `changedAt` of the last change you processed and, on your next sync, filter for changes newer than that timestamp (for example, `filter=changedAt>2024-06-01T12:00:00Z`). Do not persist `nextUrl` between syncs, since it is `null` once you are caught up. Changes are returned in ascending order of `changedAt`, then by internal change ID. Only fields with change tracking enabled are included. You can filter results using the `filter` query parameter. | **Property Name** | **Type** | **Description** | **Allowed Operators** | **Examples** | |---|---|---|---|---| | `field.id` | `text` | | `=` | `field.id=field-1234` | | `listEntry.id` | `int64` | | `=` | `listEntry.id=5678` | | `changer.id` | `int64` | The person who made the change. | `=` | `changer.id=9012` | | `changedAt` | `datetime` | When the change was made. | `>`, `<`, `>=`, `<=` | `changedAt>=2025-01-01T00:00:00Z` | | `actionType` | `text` | The type of change (`add`, `update`, `delete`) | `=` | `actionType=add` | Filters can be combined: - `|` (OR) to match any of multiple values: `field.id=field-1 | field.id=field-2` - `&` (AND) to require all conditions: `changedAt>=2025-01-01T00:00:00Z & changedAt<=2025-12-31T23:59:59Z` ## Query parameters - `filter` string - `orderBy` string[] - `cursor` string - `limit` integer ## Response `200` OK - FieldValueChangesFieldValueChangePaged - `data` FieldValueChangesFieldValueChange[], required — The field value changes for this page - union - FieldValueChangesCompanyValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesCompanyMultiValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesDatetimeValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesDropdownValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesDropdownMultiValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesFilterableTextValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesFilterableTextMultiValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesLocationValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesLocationMultiValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesNumberValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesNumberMultiValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesPersonValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesPersonMultiValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesRankedDropdownValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - FieldValueChangesTextValueChange - `id` integer, required — The unique identifier of this field value change record - `field` FieldValueChangesField, required - `id` string, required — The unique identifier of the field - `entityType` 'person' | 'company' | 'opportunity', required — The type of entity this field belongs to - `name` string, required — The name of the field - `type` 'global' | 'list', required — Whether this field is global or list-specific - `entity` FieldValueChangesEntityReference, required - `id` integer, required — The entity's unique identifier - `listEntry` FieldValueChangesListEntry, required - `id` integer, required — The list entry's unique identifier - `listId` integer, required — The ID of the list that this list entry belongs to - `changer` User, required - `id` integer, required — The user's unique identifier - `firstName` string, required — The user's first name - `lastName` string, nullable, required — The user's last name - `emailAddress` string, email, required — The user's email address - `changedAt` string, date-time, required — When the field value change occurred - `actionType` 'add' | 'update' | 'delete', required — The type of change. `add` — a value was set for the first time or added to a multi-value field. `update` — an existing single-value field was changed. `delete` — a value was cleared or removed from a multi-value field. Multi-value field types (`person-multi`, `company-multi`, `dropdown-multi`, `number-multi`, `location-multi`, `filterable-text-multi`) only produce `add` or `delete` actions; they never produce `update`. - `pagination` Pagination, required - `prevUrl` string, uri, nullable — URL for the previous page - `nextUrl` string, uri, nullable — URL for the next page ## Other responses - `400` — Bad Request - `403` — Forbidden - `default` — Errors --- [API](https://skmtc.net/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.net/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/revisions/4c2891c31b7f/schema)