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

# Get Company Merge

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

Retrieve the status and details of a specific company merge.

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

The `mergeId` can be obtained from the response of the [Get All Company Merges](/api-reference/company-merges/get-all-company-merges) endpoint, or by filtering company merges by task ID using `/v2/company-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

- CompanyMergeState — Entity representing the state of an individual company 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
  - `primaryCompanyId` integer, required — ID of the primary company that other profiles were merged into
  - `duplicateCompanyId` integer, required — ID of the duplicate company that was merged into the primary company
  - `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)