> ## 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 Persons Person ID Fields Get > Get field values on a single Person. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost. Get field values on a single Person. Tool ID: `affinity_v2_persons_person_id_fields_get` ## 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_persons_person_id_fields_get', { "personId": 123 }, ); console.log(result.toolResponse.raw); ``` ### CLI ```bash theme={null} deepline tools execute affinity_v2_persons_person_id_fields_get --input '{ "personId": 123 }' --json ``` ## Example response The static output schema is not detailed enough to generate a reliable example. Use `deepline tools get affinity_v2_persons_person_id_fields_get --json` for the complete live contract. ## Input reference \| ⚠️ This endpoint is currently in BETA | |--| Paginate through field values on a single person. Enriched, global, and relationship-intelligence fields will be included by default. The `ids` and `types` parameters can be used to filter the collection. These parameters are mutually exclusive. List fields are not returned by this endpoint. To retrieve or update list field values, use the [list entry fields](/docs/api-reference/lists/get-field-values-on-a-single-list-entry) endpoints. | Name | Type | Required | Default | Details | | ------------------ | --------- | -------- | ------- | --------------------------------------------------------------------------------- | | `payload.personId` | `integer` | Yes | — | Person ID Format: `int64`. Minimum: 1. Maximum: 9007199254740991. | | `payload.ids` | `array` | No | — | Field IDs for which to return field data | | `payload.types` | `array` | No | — | Field Types for which to return field data | | `payload.cursor` | `string` | No | — | Cursor for the next or previous page | | `payload.limit` | `integer` | No | `20` | Number of items to include in the page Format: `int32`. Minimum: 1. Maximum: 100. |
Show raw input schema ### Input JSON Schema ```json theme={null} { "type": "object", "description": "| ⚠️ This endpoint is currently in BETA | |--| Paginate through field values on a single person. Enriched, global, and relationship-intelligence fields will be included by default. The `ids` and `types` parameters can be used to filter the collection. These parameters are mutually exclusive. List fields are not returned by this endpoint. To retrieve or update list field values, use the [list entry fields](/api-reference/lists/get-field-values-on-a-single-list-entry) endpoints.", "properties": { "personId": { "type": "integer", "description": "Person ID", "minimum": 1, "maximum": 9007199254740991, "format": "int64" }, "ids": { "type": "array", "description": "Field IDs for which to return field data", "items": { "type": "string" } }, "types": { "type": "array", "description": "Field Types for which to return field data", "items": { "type": "string", "enum": [ "enriched", "global", "relationship-intelligence" ] } }, "cursor": { "type": "string", "description": "Cursor for the next or previous page" }, "limit": { "type": "integer", "description": "Number of items to include in the page", "default": 20, "minimum": 1, "maximum": 100, "format": "int32" } }, "required": [ "personId" ], "additionalProperties": false } ```
## Output reference | Name | Type | Required | Default | Details | | ----------------------------------------------------- | ----------------------------------------------------------------------------- | -------- | ------- | ----------------------------------------------------------------------------- | | `result.data` | `object` | Yes | — | — | | `result.data.data` | `array` | Yes | — | Maximum items: 100. | | `result.data.data[].id` | `string` | Yes | — | — | | `result.data.data[].name` | `string` | Yes | — | — | | `result.data.data[].type` | `"enriched" \| "global" \| "list" \| "relationship-intelligence" \| "hidden"` | Yes | — | Allowed: `enriched`, `global`, `list`, `relationship-intelligence`, `hidden`. | | `result.data.data[].enrichmentSource` | `"affinity-data" \| "dealroom" \| "eventbrite" \| "mailchimp" \| null` | Yes | — | Allowed: `affinity-data`, `dealroom`, `eventbrite`, `mailchimp`, `null`. | | `result.data.data[].value` | `object` | Yes | — | — | | `result.data.data[].value.type` | `"company-multi"` | Yes | — | — | | `result.data.data[].value.data` | `array \| null` | Yes | — | — | | `result.data.data[].value.data[].id` | `integer` | Yes | — | — | | `result.data.data[].value.data[].name` | `string` | Yes | — | — | | `result.data.data[].value.data[].domain` | `string \| null` | Yes | — | — | | `result.data.data[].value.totalCount` | `integer` | No | — | Format: `int32`. Minimum: 0. Maximum: 2147483647. | | `result.data.data[].value.data[].dropdownOptionId` | `integer` | Yes | — | — | | `result.data.data[].value.data[].text` | `string` | Yes | — | — | | `result.data.data[].value.data[].streetAddress` | `string \| null` | Yes | — | — | | `result.data.data[].value.data[].city` | `string \| null` | Yes | — | — | | `result.data.data[].value.data[].state` | `string \| null` | Yes | — | — | | `result.data.data[].value.data[].country` | `string \| null` | Yes | — | — | | `result.data.data[].value.data[].continent` | `string \| null` | Yes | — | — | | `result.data.data[].value.data[].firstName` | `string \| null` | Yes | — | — | | `result.data.data[].value.data[].lastName` | `string \| null` | Yes | — | — | | `result.data.data[].value.data[].primaryEmailAddress` | `string \| null` | Yes | — | — | | `result.data.data[].value.data[].type` | `"internal" \| "collaborator" \| "external"` | 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 | — | — | This output schema is too large to embed without slowing the page. Get the complete live contract with `deepline tools get affinity_v2_persons_person_id_fields_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](/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)