List person record attribute values
Gets all values for a given attribute on a person record. Historic values can be queried using the show_historic
query param. Historic values cannot be queried on COMINT (Communication Intelligence) or enriched attributes and the endpoint will return a 400 error if this is attempted. Historic values are sorted from oldest to newest (by active_from
). Some attributes are subject to billing status and will return an empty array of values if theworkspace being queried does not have the required billing flag enabled.
Required scopes: record_permission:read
, object_configuration:read
.
Authorizations
This API uses OAuth 2.0 with the authorization code grant flow.
Path Parameters
A UUID of the person record to fetch attribute values for.
"891dcbfc-9141-415d-9b2a-2238a6cc012d"
A UUID or slug to identify the attribute you want to query values on.
"name"
Query Parameters
If true
, the endpoint will return all historic values for the attribute. If false
, the endpoint will only return the currently active value(s). Defaults to false
. Cannot be set to true
for COMINT attributes or enriched attributes on people/company objects.
true
The maximum number of results to return. See the full guide to pagination here.
10
The number of results to skip over before returning. See the full guide to pagination here.
5
Response
Success