---
title: "Get Person Merge"
method: GET
path: "/v2/person-merges/{mergeId}"
tags: ["Person Merges"]
---

# Get Person Merge

`GET /v2/person-merges/{mergeId}`

Retrieve the status and details of a specific person merge.

Returns information about the person merge including its current status, the persons involved, timestamps, and any error information if the merge failed.

The `mergeId` can be obtained from the response of the [Get All Person Merges](/api-reference/person-merges/get-all-person-merges) endpoint, or by filtering person merges by task ID using `/v2/person-merges?filter=taskId={taskId}` after initiating a merge.

Requires the "Manage duplicates" [permission](/pages/external-api-v2/permissions) and organization admin role.

## Path parameters

- `mergeId` integer, required

## Response `200`

OK

- PersonMergeState — Entity representing the state of an individual person merge
  - `id` integer, required — The unique identifier for the merge
  - `status` 'in-progress' | 'success' | 'failed', required — Current status of the merge
  - `taskId` string, uuid, required — Identifier for the task this merge belongs to
  - `startedAt` string, date-time, required — Timestamp when the merge started
  - `primaryPersonId` integer, required — ID of the primary person that other profiles were merged into
  - `duplicatePersonId` integer, required — ID of the duplicate person that was merged into the primary person
  - `completedAt` string, date-time, nullable, required — Timestamp when the merge completed (success or failure)
  - `errorMessage` string, nullable, required — Error message if the merge failed

## 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/versions/4c2891c31b7f/schema)