Affinity: V2 Persons Person ID Get

Get a single Person.

Tool ID: affinity_v2_persons_person_id_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.

import { Deepline } from 'deepline';

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

console.log(result.toolResponse.raw);

CLI

deepline tools execute affinity_v2_persons_person_id_get --input '{
  "personId": 123
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "id": 123,
    "firstName": "Jane",
    "lastName": "Doe",
    "primaryEmailAddress": "jane.doe@example.com",
    "emailAddresses": [
      "jane.doe@example.com"
    ],
    "type": "internal"
  }
}

Use deepline tools get affinity_v2_persons_person_id_get --json for the latest machine-readable contract.

Input reference

Returns basic information and non-list-specific field data on the requested Person. To retrieve field data, you must use either the fieldIds or the fieldTypes parameter to specify the Fields for which you want data returned. These Field IDs and Types can be found using the GET /v2/persons/fields endpoint. When no fieldIds or fieldTypes are provided, Persons will be returned without any field data attached. To supply multiple fieldIds or fieldTypes parameters, generate a query string that looks like this: ?fieldIds=field-1234&fieldIds=affinity-data-location or ?fieldTypes=enriched&fieldTypes=global.

Name	Type	Required	Default	Details
`payload.personId`	`integer`	Yes	—	Person ID Format: `int64`. Minimum: 1. Maximum: 9007199254740991.
`payload.fieldIds`	`array`	No	—	Field IDs for which to return field data
`payload.fieldTypes`	`array`	No	—	Field Types for which to return field data

Output reference

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	—
`result.data.id`	`integer`	Yes	—	Format: `int64`. Minimum: 1. Maximum: 9007199254740991.
`result.data.firstName`	`string`	Yes	—	—
`result.data.lastName`	`string \| null`	Yes	—	—
`result.data.primaryEmailAddress`	`string \| null`	Yes	—	Format: `email`.
`result.data.emailAddresses`	`array`	Yes	—	—
`result.data.type`	`"internal" \| "external"`	Yes	—	Allowed: `internal`, `external`.
`result.data.fields`	`array`	No	—	—
`result.data.fields[].id`	`string`	Yes	—	—
`result.data.fields[].name`	`string`	Yes	—	—
`result.data.fields[].type`	`"enriched" \| "global" \| "list" \| "relationship-intelligence" \| "hidden"`	Yes	—	Allowed: `enriched`, `global`, `list`, `relationship-intelligence`, `hidden`.
`result.data.fields[].enrichmentSource`	`"affinity-data" \| "dealroom" \| "eventbrite" \| "mailchimp" \| null`	Yes	—	Allowed: `affinity-data`, `dealroom`, `eventbrite`, `mailchimp`, `null`.
`result.data.fields[].value`	`object`	Yes	—	—
`result.data.fields[].value.type`	`"company-multi"`	Yes	—	—
`result.data.fields[].value.data`	`array \| null`	Yes	—	—
`result.data.fields[].value.data[].id`	`integer`	Yes	—	—
`result.data.fields[].value.data[].name`	`string`	Yes	—	—
`result.data.fields[].value.data[].domain`	`string \| null`	Yes	—	—
`result.data.fields[].value.totalCount`	`integer`	No	—	Format: `int32`. Minimum: 0. Maximum: 2147483647.
`result.data.fields[].value.data[].dropdownOptionId`	`integer`	Yes	—	—
`result.data.fields[].value.data[].text`	`string`	Yes	—	—
`result.data.fields[].value.data[].streetAddress`	`string \| null`	Yes	—	—
`result.data.fields[].value.data[].city`	`string \| null`	Yes	—	—
`result.data.fields[].value.data[].state`	`string \| null`	Yes	—	—
`result.data.fields[].value.data[].country`	`string \| null`	Yes	—	—
`result.data.fields[].value.data[].continent`	`string \| null`	Yes	—	—
`result.data.fields[].value.data[].firstName`	`string \| null`	Yes	—	—
`result.data.fields[].value.data[].lastName`	`string \| null`	Yes	—	—
`result.data.fields[].value.data[].primaryEmailAddress`	`string \| null`	Yes	—	—
`result.data.fields[].value.data[].type`	`"internal" \| "collaborator" \| "external"`	Yes	—	—
`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_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.

Getting Started

GTM is code

Features

Deepline SDK beta

Integrations

API Reference

Affinity: V2 Persons Person ID Get

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation