---
title: "Get field values on a single Person"
method: GET
path: "/v2/persons/{personId}/fields"
tags: ["Persons"]
---

# Get field values on a single Person

`GET /v2/persons/{personId}/fields`

| ⚠️  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.

## Path parameters

- `personId` integer, required

## Query parameters

- `ids` string[]
- `types` string[]
- `cursor` string
- `limit` integer

## Response `200`

OK

- FieldPaged — FieldPaged model
  - `data` Field[], required — A page of Field results
    - `id` string, required — The field's unique identifier
    - `name` string, required — The field's name
    - `type` 'enriched' | 'global' | 'list' | 'relationship-intelligence' | 'hidden', required — The field's category. `hidden` is a redaction state rather than a category: it signals a field on a restricted opportunity the caller cannot manage, whose value is masked.
    - `enrichmentSource` 'affinity-data' | 'dealroom' | 'eventbrite' | 'mailchimp' | 'null', nullable, required — The source of the data in this Field (if it is enriched)
    - `value` union, required
      - CompaniesValue
        - `type` 'company-multi', required — The type of value
        - `data` CompanyData[], nullable, required — The values for many companies
          - `id` integer, required — The company's unique identifier
          - `name` string, required — The company's name
          - `domain` string, hostname, nullable, required — The company's primary domain
        - `totalCount` integer — The total number of values for this field. When totalCount exceeds the length of data, additional values can be retrieved using the field values endpoint.
      - CompanyValue
        - `type` 'company', required — The type of value
        - `data` CompanyData, required
          - `id` integer, required — The company's unique identifier
          - `name` string, required — The company's name
          - `domain` string, hostname, nullable, required — The company's primary domain
      - DateValue
        - `type` 'datetime', required — The type of value
        - `data` string, date-time, nullable, required — The value for a date
      - DropdownsValue
        - `type` 'dropdown-multi', required — The type of value
        - `data` Dropdown[], nullable, required — The value for many dropdown items
          - `dropdownOptionId` integer, required — Dropdown item's unique identifier
          - `text` string, required — Dropdown item text
        - `totalCount` integer — The total number of values for this field. When totalCount exceeds the length of data, additional values can be retrieved using the field values endpoint.
      - DropdownValue
        - `type` 'dropdown', required — The type of value
        - `data` Dropdown, required
          - `dropdownOptionId` integer, required — Dropdown item's unique identifier
          - `text` string, required — Dropdown item text
      - FloatsValue
        - `type` 'number-multi', required — The type of value
        - `data` number[], nullable, required — The value for many numbers
        - `totalCount` integer — The total number of values for this field. When totalCount exceeds the length of data, additional values can be retrieved using the field values endpoint.
      - FloatValue
        - `type` 'number', required — The type of value
        - `data` number, nullable, required — The value for a number
      - FormulaValue
        - `type` 'formula-number', required — The type of value
        - `data` FormulaNumber, required
          - `calculatedValue` number, nullable — Calculated value
      - InteractionValue
        - `type` 'interaction', required — The type of value
        - `data` union, required
          - ChatMessage
            - `type` 'chat-message', required — The type of interaction
            - `id` integer, required — The chat message's unique identifier
            - `direction` 'received' | 'sent', required — The direction of the chat message
            - `sentAt` string, date-time, required — The time the chat message was sent
            - `manualCreator` PersonData, required
              - …
            - `participants` PersonData[], required — The participants of the chat
              - …
          - Email
            - `type` 'email', required — The type of interaction
            - `id` integer, required — The email's unique identifier
            - `subject` string, nullable, required — The subject of the email
            - `sentAt` string, date-time, required — The time the email was sent
            - `from` Attendee, required
              - …
            - `to` Attendee[], required — The recipients of the email
              - …
            - `cc` Attendee[], required — The cc recipients of the email
              - …
          - Meeting
            - `type` 'meeting', required — The type of interaction
            - `id` integer, required — The meeting's unique identifier
            - `title` string, nullable, required — The meeting's title
            - `allDay` boolean, required — Whether the meeting is an all-day event
            - `startTime` string, date-time, required — The meeting start time
            - `endTime` string, date-time, nullable, required — The meeting end time
            - `attendees` Attendee[], required — People attending the meeting
              - …
          - PhoneCall
            - `type` 'call', required — The type of interaction
            - `id` integer, required — The phone call's unique identifier
            - `startTime` string, date-time, required — The call start time
            - `attendees` Attendee[], required — People attending the call
              - …
      - LocationsValue
        - `type` 'location-multi', required — The type of value
        - `data` Location[], nullable, required — The values for many locations
          - `streetAddress` string, nullable, required — Street address
          - `city` string, nullable, required — City
          - `state` string, nullable, required — State
          - `country` string, nullable, required — Country
          - `continent` string, nullable, required — Continent
        - `totalCount` integer — The total number of values for this field. When totalCount exceeds the length of data, additional values can be retrieved using the field values endpoint.
      - LocationValue
        - `type` 'location', required — The type of value
        - `data` Location, required
          - `streetAddress` string, nullable, required — Street address
          - `city` string, nullable, required — City
          - `state` string, nullable, required — State
          - `country` string, nullable, required — Country
          - `continent` string, nullable, required — Continent
      - PersonsValue
        - `type` 'person-multi', required — The type of value
        - `data` PersonData[], nullable, required — The values for many persons
          - `id` integer, required — The persons's unique identifier
          - `firstName` string, nullable, required — The person's first name
          - `lastName` string, nullable, required — The person's last name
          - `primaryEmailAddress` string, email, nullable, required — The person's primary email address
          - `type` 'internal' | 'collaborator' | 'external', required — The person's type. `internal` - people who are users within your Affinity instance. `collaborator` - individuals outside of your company who have read-only access to specified Affinity list views and stay updated on your firm's activities. `external` - people who are not internal nor collaborators.
        - `totalCount` integer — The total number of values for this field. When totalCount exceeds the length of data, additional values can be retrieved using the field values endpoint.
      - PersonValue
        - `type` 'person', required — The type of value
        - `data` PersonData, required
          - `id` integer, required — The persons's unique identifier
          - `firstName` string, nullable, required — The person's first name
          - `lastName` string, nullable, required — The person's last name
          - `primaryEmailAddress` string, email, nullable, required — The person's primary email address
          - `type` 'internal' | 'collaborator' | 'external', required — The person's type. `internal` - people who are users within your Affinity instance. `collaborator` - individuals outside of your company who have read-only access to specified Affinity list views and stay updated on your firm's activities. `external` - people who are not internal nor collaborators.
      - RankedDropdownValue
        - `type` 'ranked-dropdown', required — The type of value
        - `data` RankedDropdown, required
          - `dropdownOptionId` integer, required — Dropdown item's unique identifier
          - `text` string, required — Dropdown item text
          - `rank` integer, required — Dropdown item rank
          - `color` string, nullable, required — Dropdown item color
      - TextsValue
        - `type` 'filterable-text-multi', required — The type of value
        - `data` string[], nullable, required — The value for many strings
        - `totalCount` integer — The total number of values for this field. When totalCount exceeds the length of data, additional values can be retrieved using the field values endpoint.
      - TextValue
        - `type` 'filterable-text' | 'text', required — The type of value
        - `data` string, nullable, required — The value for a string
  - `pagination` Pagination, required
    - `prevUrl` string, uri, nullable — URL for the previous page
    - `nextUrl` string, uri, nullable — URL for the next page

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `default` — Errors

---

[API](https://skmtc.net/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.net/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/revisions/4c2891c31b7f/schema)