> ## 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

> Get Field Value Changes on a List Entry. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Get Field Value Changes on a List Entry.

<Info>
  Tool ID: `affinity_v2_lists_list_id_list_entries_list_entry_id_field_value_changes_get`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
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={null}
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 is not detailed enough to generate a reliable example. Use `deepline tools get 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](/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. | `&gt;`, ` =`, \` 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={null}
  {
    "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       | —       | —                                                       |

<Info>
  This output schema is too large to embed without slowing the page. Get the complete live contract with `deepline tools get affinity_v2_lists_list_id_list_entries_list_entry_id_field_value_changes_get --json`.
</Info>

## 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](/docs/providers/affinity/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)
