# Merge two identities

Retires one identity into another by merging data from a retiring source
into a surviving source. Returns the surviving linkId and metadata.

Endpoint: POST /mergeIdentities
Version: 2026.1.2
Security: bearerAuth

## Request fields (application/json):

  - `auditId` (string)
    Audit identifier used for tracing and governance across Verato services.

  - `auditLogMap` (object)
    Generic map of string keys to string values.

  - `content` (object)
    Request to merge (retire) one source identity into another, creating a
single surviving identity.

  - `content.toSurviveSource` (object, required)
    Tracks an identity to a particular source system and record ID.

  - `content.toSurviveSource.date` (string)
    The date of the source data in ISO format (yyyy-MM-dd).

  - `content.toSurviveSource.name` (string)
    Name of the data source. Must be unique across Verato.

  - `content.toSurviveSource.id` (string)
    ID of an identity within the given data source.

  - `content.toRetireSource` (object, required)
    Tracks an identity to a particular source system and record ID.

  - `trackingId` (string)

## Response 200 fields (application/json):

  - `auditId` (string)
    Audit identifier used for tracing and governance across Verato services.

  - `success` (boolean)

  - `unparsedJson` (string)

  - `warnings` (array)

  - `retryableError` (boolean)

  - `message` (string)

  - `content` (object)
    Response to a merge identities request, returning the surviving LINK ID
and surviving source information.

  - `content.linkId` (string)
    LINK ID of the surviving identity.

  - `content.toSurviveSource` (object)
    Tracks an identity to a particular source system and record ID.

  - `content.toSurviveSource.date` (string)
    The date of the source data in ISO format (yyyy-MM-dd).

  - `content.toSurviveSource.name` (string)
    Name of the data source. Must be unique across Verato.

  - `content.toSurviveSource.id` (string)
    ID of an identity within the given data source.

  - `errors` (array)

  - `trackingId` (string)