---
title: "Get All Person Merge Tasks"
method: GET
path: "/v2/tasks/person-merges"
tags: ["Person Merges"]
---

# Get All Person Merge Tasks

`GET /v2/tasks/person-merges`

Retrieve paginated person merge tasks for the organization.


Returns all merge tasks initiated by users in your organization, including their current status,
the persons involved, and task details.


You can filter tasks using the `filter` query parameter. The filter parameter is a string that you can specify conditions based on the following properties:

| **Property Name** | **Type** | **Allowed Operators** | **Examples** |
|---|---|---|---|
| `status` | `enum` | `=` | `status=in-progress`, `status=success`, `status=failed` |


Tasks are returned in reverse chronological order (most recent first).


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

## Query parameters

- `cursor` string
- `limit` integer
- `filter` string

## Response `200`

OK

- PersonMergeTaskPaged — Paginated person merge tasks
  - `data` PersonMergeTask[], required — Array of person merge tasks
    - `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
  - `pagination` Pagination, required
    - `prevUrl` string, uri, nullable — URL for the previous page
    - `nextUrl` string, uri, nullable — URL for the next page

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `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)