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

# Get Person Merge Task

`GET /v2/tasks/person-merges/{taskId}`

Retrieve the status and details of a specific task for person merges.


Returns information about the person merges for a specific task including its overall status,
number of merges in-progress, completed, and failed.


Detailed information about individual merges for this task can be found by querying:
`/v2/person-merges?filter=taskId={taskId}` See
[Person Merges](/api-reference/person-merges/get-all-person-merges) for more details.


Task statuses:

- `in-progress`: The merge task is currently being processed.
- `success`: The merge task completed successfully.
- `failed`: The merge task failed.


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

## Path parameters

- `taskId` string, uuid, required

## Response `200`

OK

- PersonMergeTask — Person merge task details and status for batch operations
  - `id` string, uuid, required — The unique identifier for this merge task
  - `status` 'in-progress' | 'success' | 'failed', required — The current status of the batch operation
  - `resultsSummary` object, required — Summary of merges in this batch task
    - `total` integer, required — Total number of merges in the batch
    - `inProgress` integer, required — Number of merges currently in progress
    - `success` integer, required — Number of successfully completed merges
    - `failed` integer, required — Number of failed merges

## 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)