> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Affinity: V2 Lists List ID List Entries List Entry ID Field Value Changes Get

> List the history of field value changes on one Affinity list row. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List the history of field value changes on one Affinity list row.

> [!NOTE]
>
> Tool ID: `affinity_v2_lists_list_id_list_entries_list_entry_id_field_value_changes_get`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'affinity_v2_lists_list_id_list_entries_list_entry_id_field_value_changes_get',
  {
    "listId": 123,
    "listEntryId": 123
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute affinity_v2_lists_list_id_list_entries_list_entry_id_field_value_changes_get --input '{
  "listId": 123,
  "listEntryId": 123
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe affinity_v2_lists_list_id_list_entries_list_entry_id_field_value_changes_get --json` for the complete live contract.

## Input reference

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](https://deepline.com/docs/pages/data-model/working-with-field-data#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. | `>`, ` =`, \` See the live schema below for the complete notes.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.listId` | `integer` | Yes | — | List ID Format: `int64`. Minimum: 1. Maximum: 9007199254740991. |
| `payload.listEntryId` | `integer` | Yes | — | List Entry ID Format: `int64`. Minimum: 1. Maximum: 9007199254740991. |
| `payload.filter` | `string` | No | — | Filter options |
| `payload.cursor` | `string` | No | — | Cursor for the next or previous page |
| `payload.limit` | `integer` | No | `100` | Number of items to include in the page Format: `int32`. Minimum: 1. Maximum: 100. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "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](/pages/data-model/working-with-field-data#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. | `>`, ` =`, ` 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` |",
    "properties": {
      "listId": {
        "type": "integer",
        "description": "List ID",
        "minimum": 1,
        "maximum": 9007199254740991,
        "format": "int64"
      },
      "listEntryId": {
        "type": "integer",
        "description": "List Entry ID",
        "minimum": 1,
        "maximum": 9007199254740991,
        "format": "int64"
      },
      "filter": {
        "type": "string",
        "description": "Filter options"
      },
      "cursor": {
        "type": "string",
        "description": "Cursor for the next or previous page"
      },
      "limit": {
        "type": "integer",
        "description": "Number of items to include in the page",
        "default": 100,
        "minimum": 1,
        "maximum": 100,
        "format": "int32"
      }
    },
    "required": [
      "listId",
      "listEntryId"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | — |
| `result.data.data` | `array` | Yes | — | Maximum items: 100. |
| `result.data.data[].id` | `integer` | Yes | — | Format: `int64`. Minimum: 1. Maximum: 9007199254740991. |
| `result.data.data[].field` | `object` | Yes | — | — |
| `result.data.data[].field.id` | `string` | Yes | — | — |
| `result.data.data[].field.entityType` | `"person" \| "company" \| "opportunity"` | Yes | — | Allowed: `person`, `company`, `opportunity`. |
| `result.data.data[].field.name` | `string` | Yes | — | — |
| `result.data.data[].field.type` | `"global" \| "list"` | Yes | — | Allowed: `global`, `list`. |
| `result.data.data[].entity` | `object` | Yes | — | — |
| `result.data.data[].entity.id` | `integer` | Yes | — | Format: `int64`. Minimum: 1. Maximum: 9007199254740991. |
| `result.data.data[].listEntry` | `record` | Yes | — | — |
| `result.data.data[].changer` | `record` | Yes | — | — |
| `result.data.data[].changedAt` | `string` | Yes | — | Format: `date-time`. |
| `result.data.data[].actionType` | `"add" \| "update" \| "delete"` | Yes | — | Allowed: `add`, `update`, `delete`. |
| `result.data.data[].type` | `"company" \| "company-multi" \| "datetime" \| "dropdown" \| "dropdown-multi" \| "filterable-text" \| "filterable-text-multi" \| "location" \| "location-multi" \| "number" \| "number-multi" \| "person" \| "person-multi" \| "ranked-dropdown" \| "text"` | Yes | — | — |
| `result.data.data[].value` | `object \| string \| number` | Yes | — | — |
| `result.data.data[].value.referenceType` | `"entity"` | Yes | — | — |
| `result.data.data[].value.id` | `integer` | Yes | — | — |
| `result.data.data[].value.name` | `string` | Yes | — | — |
| `result.data.data[].value.domain` | `string \| null` | Yes | — | — |
| `result.data.data[].value.displayValue` | `string` | Yes | — | — |
| `result.data.data[].value.dropdownOptionId` | `integer` | Yes | — | — |
| `result.data.data[].value.text` | `string` | Yes | — | — |
| `result.data.data[].value.streetAddress` | `string \| null` | Yes | — | — |
| `result.data.data[].value.city` | `string \| null` | Yes | — | — |
| `result.data.data[].value.state` | `string \| null` | Yes | — | — |
| `result.data.data[].value.country` | `string \| null` | Yes | — | — |
| `result.data.data[].value.continent` | `string \| null` | Yes | — | — |
| `result.data.data[].value.firstName` | `string \| null` | Yes | — | — |
| `result.data.data[].value.lastName` | `string \| null` | Yes | — | — |
| `result.data.data[].value.primaryEmailAddress` | `string \| null` | Yes | — | — |
| `result.data.data[].value.type` | `"internal" \| "collaborator" \| "external"` | Yes | — | — |
| `result.data.data[].value.rank` | `integer` | Yes | — | — |
| `result.data.data[].value.color` | `string \| null` | Yes | — | — |
| `result.data.pagination` | `object` | Yes | — | — |
| `result.data.pagination.prevUrl` | `string \| null` | No | — | Format: `uri`. |
| `result.data.pagination.nextUrl` | `string \| null` | No | — | Format: `uri`. |
| `result.meta` | `object` | No | — | — |

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe affinity_v2_lists_list_id_list_entries_list_entry_id_field_value_changes_get --json`.

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Affinity provider guide](https://deepline.com/docs/providers/affinity/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.