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

# Get Company Merge Task

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

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


Returns information about the company 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/company-merges?filter=taskId={taskId}` See
[Company Merges](/api-reference/company-merges/get-all-company-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

- CompanyMergeTask — Company 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)