Skip to main content
GET
Get identity history for a person

Authorizations

Authorization
string
header
required

Path Parameters

person_id
string
required

Extole person id.

Response

Successful response

log_date
string
required

RFC 3339 or RFC 9557 date-time with a numeric UTC offset and an optional IANA time-zone suffix in square brackets. Precision up to milliseconds.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])(\[[^\]]+\])?$
Example:

"2025-10-24T02:00:00-07:00"

old_identity_key_name
string
required

Name of the identity key before the change. Absent if not applicable.

old_identity_key_value
string
required

Value of the identity key before the change. Absent if not applicable.

type
enum<string>
required

Type of identity event (IDENTITY_SHIFT or SPLIT_LOSER).

Available options:
IDENTITY_SHIFT
identity_profile_update_version
integer<int32>
required

Version number of the identity profile after the shift. Absent for older entries.

identity_shape_shift_type
enum<string>
required

The specific type of identity shape shift that occurred.

Available options:
ANONYMOUS_NO_KEY,
ANONYMOUS_WITH_KEY,
DEVICE_AND_IDENTITY_MERGED,
DEVICE_AND_IDENTITY_WITH_DIFFERENT_KEY,
DEVICE_AND_IDENTITY_WITH_KEY,
DEVICE_MERGED,
DEVICE_NO_KEY,
DEVICE_NO_KEY_IDENTITY_WITH_KEY,
DEVICE_WITH_DIFFERENT_KEY,
DEVICE_WITH_KEY,
IDENTITY_MERGED,
IDENTITY_WITH_KEY