> ## Documentation Index > Fetch the complete documentation index at: https://doc.extole.com/llms.txt > Use this file to discover all available pages before exploring further. # Get identity history for a person > Returns the chronological log of identity-merge and identity-link events for the specified person. Each entry records the event type, the previous identity key information, and the event date. Use this to audit how a person's unified profile evolved over time. ## OpenAPI ````yaml /api-reference/integration-server-to-extole.json get /v5/persons/{person_id}/identity-history openapi: 3.0.1 info: description: >- Server-to-Extole integration endpoints: event submission, person lookup, zone rendering, token management, and reward retrieval for backend services authenticating with client credentials. title: Integration API - Server to Extole version: '1.0' servers: - description: Production url: https://api.extole.io security: - HEADER: [] - QUERY: [] - COOKIE: [] tags: - name: Authentication - name: Batch Jobs - name: Events - name: Files - name: Persons - name: Reward Suppliers - name: Rewards - name: SFTP Servers - name: Zone Rendering paths: /v5/persons/{person_id}/identity-history: get: tags: - Persons summary: Get identity history for a person description: >- Returns the chronological log of identity-merge and identity-link events for the specified person. Each entry records the event type, the previous identity key information, and the event date. Use this to audit how a person's unified profile evolved over time. operationId: getIdentityHistory parameters: - description: Extole person id. in: path name: person_id required: true schema: type: string responses: '200': content: application/json: schema: items: $ref: '#/components/schemas/IdentityLogResponse' type: array description: Successful response '400': content: application/json: examples: binding_error: $ref: '#/components/examples/binding_error' invalid_json: $ref: '#/components/examples/invalid_json' invalid_parameter: $ref: '#/components/examples/invalid_parameter' missing_request_body: $ref: '#/components/examples/missing_request_body' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Bad Request '401': content: application/json: examples: method_unauthorized: $ref: '#/components/examples/method_unauthorized' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Unauthorized '402': content: application/json: examples: payment_required: $ref: '#/components/examples/payment_required' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Payment Required '403': content: application/json: examples: access_denied: $ref: '#/components/examples/access_denied' method_unauthorized: $ref: '#/components/examples/method_unauthorized' missing_access_token: $ref: '#/components/examples/missing_access_token' person_not_found: $ref: '#/components/examples/person_not_found' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Forbidden '415': content: application/json: examples: unsupported_media_type: $ref: '#/components/examples/unsupported_media_type' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Unsupported Media Type '429': content: application/json: examples: too_many_requests: $ref: '#/components/examples/too_many_requests' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Too Many Requests components: schemas: IdentityLogResponse: discriminator: mapping: IDENTITY_SHIFT: $ref: '#/components/schemas/PersonIdentityShapeShiftResponse' SPLIT_LOSER: $ref: '#/components/schemas/PersonIdentityHistoryResponse' propertyName: type oneOf: - title: IDENTITY_SHIFT allOf: - $ref: '#/components/schemas/PersonIdentityShapeShiftResponse' - title: SPLIT_LOSER allOf: - $ref: '#/components/schemas/PersonIdentityHistoryResponse' required: - log_date - old_identity_key_name - old_identity_key_value - type RestExceptionResponse: description: Represents the API error response properties: code: description: Specific error code for this error type, documented per endpoint type: string http_status_code: description: >- HTTP status code that was returned with this error, useful if client get response code format: int32 type: integer message: description: User readable English description of the error type: string parameters: additionalProperties: description: >- Attributes related to the error, varies be error code, documented per endpoint type: object description: >- Attributes related to the error, varies be error code, documented per endpoint type: object unique_id: description: >- Unique id associated with this error, useful for discussions with Extole type: string required: - code - http_status_code - message - parameters - unique_id type: object PersonIdentityShapeShiftResponse: allOf: - $ref: '#/components/schemas/IdentityLogResponseBase' - properties: identity_profile_update_version: description: >- Version number of the identity profile after the shift. Absent for older entries. format: int32 type: integer identity_shape_shift_type: description: The specific type of identity shape shift that occurred. enum: - 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 type: string type: enum: - IDENTITY_SHIFT type: string type: object required: - identity_profile_update_version - identity_shape_shift_type - log_date - old_identity_key_name - old_identity_key_value - type type: object title: IDENTITY_SHIFT PersonIdentityHistoryResponse: allOf: - $ref: '#/components/schemas/IdentityLogResponseBase' - properties: losing_identity_key_value: description: >- Identity key value of this (losing) profile before the split. Absent if not applicable. type: string type: enum: - SPLIT_LOSER type: string winning_identity_id: description: >- Extole person id of the winning (surviving) profile. Absent if not applicable. type: string winning_identity_key_name: description: >- Identity key name of the winning (surviving) profile after the split. Absent if not applicable. type: string winning_identity_key_value: description: >- Identity key value of the winning (surviving) profile after the split. Absent if not applicable. type: string type: object required: - log_date - losing_identity_key_value - old_identity_key_name - old_identity_key_value - type - winning_identity_id - winning_identity_key_name - winning_identity_key_value type: object title: SPLIT_LOSER IdentityLogResponseBase: properties: log_date: $ref: '#/components/schemas/ZonedDateTime' old_identity_key_name: description: >- Name of the identity key before the change. Absent if not applicable. type: string old_identity_key_value: description: >- Value of the identity key before the change. Absent if not applicable. type: string type: description: Type of identity event (`IDENTITY_SHIFT` or `SPLIT_LOSER`). enum: - IDENTITY_SHIFT - SPLIT_LOSER type: string type: object ZonedDateTime: description: >- [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) or [RFC 9557](https://datatracker.ietf.org/doc/html/rfc9557#section-4) date-time with a numeric [UTC offset](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and an optional [IANA time-zone](https://datatracker.ietf.org/doc/html/rfc9557#section-4) suffix in square brackets. Precision up to milliseconds. example: '2025-10-24T02:00:00-07:00' 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])(\[[^\]]+\])?$ type: string examples: binding_error: summary: binding_error value: code: binding_error http_status_code: 400 message: Argument is not of the expected type parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_json: summary: invalid_json value: code: invalid_json http_status_code: 400 message: JSON is invalid parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_parameter: summary: invalid_parameter value: code: invalid_parameter http_status_code: 400 message: Parameter is invalid. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 missing_request_body: summary: missing_request_body value: code: missing_request_body http_status_code: 400 message: Missing request body parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 method_unauthorized: summary: method_unauthorized value: code: method_unauthorized http_status_code: 401 message: Unauthorized access to this endpoint parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 payment_required: summary: payment_required value: code: payment_required http_status_code: 402 message: The access_token provided is associated with an unpaid account. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 access_denied: summary: access_denied value: code: access_denied http_status_code: 403 message: >- The access_token provided is not permitted to access the specified resource. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 missing_access_token: summary: missing_access_token value: code: missing_access_token http_status_code: 403 message: No access_token was provided with this request. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 person_not_found: summary: person_not_found value: code: person_not_found http_status_code: 403 message: Person not found parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 unsupported_media_type: summary: unsupported_media_type value: code: unsupported_media_type http_status_code: 415 message: Request had an unsupported or no media type parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 too_many_requests: summary: too_many_requests value: code: too_many_requests http_status_code: 429 message: >- The server is unable to process your request at the moment, please retry later. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 securitySchemes: HEADER: in: header name: Authorization type: apiKey x-bearer-format: bearer QUERY: in: query name: access_token type: apiKey COOKIE: in: cookie name: extole_token type: apiKey ````