v1

latestOpenAPI 3.1.1Proprietary2026-07-2687313591.4 KB

Persons

Get a single Person

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.

get/v2/persons/{personId}

Path parameters

personIdinteger required

Person ID

Query parameters

fieldIdsstring[]

Field IDs for which to return field data

[
  "field-1"
]

fieldTypesstring[]

Field Types for which to return field data

Response

idinteger required

The persons's unique identifier

firstNamestring required

The person's first name

lastNamestring nullable required

The person's last name

primaryEmailAddressstring email nullable required

The person's primary email address

emailAddressesstring[] required

All of the person's email addresses

type'internal' | 'external' required

The person's type. internal - people who are users within your Affinity instance. external - people who are not internal.

Example response

{
  "id": 1,
  "firstName": "Jane",
  "lastName": "Doe",
  "primaryEmailAddress": "jane.smith@northpointvc.com",
  "emailAddresses": [
    "jane.smith@northpointvc.com",
    "janedoe@gmail.com"
  ],
  "type": "internal",
  "fields": [
    {
      "id": "affinity-data-location",
      "name": "Location",
      "type": "enriched",
      "enrichmentSource": "affinity-data",
      "value": {
        "type": "company-multi",
        "data": [
          {
            "id": 1,
            "name": "Horizon Technologies",
            "domain": "horizontech.com"
          },
          {
            "id": 2,
            "name": "Crestwood Capital",
            "domain": "crestwoodcap.com"
          }
        ]
      }
    }
  ]
}