Skip to content

Get merge status

$ lightfield merge get-merge
GET/v1/merges/{id}

Returns the status and details of a merge operation by its ID.

Rate limit category: Read

ParametersExpand Collapse
--id: string

The merge operation ID.

ReturnsExpand Collapse
merge_get_merge_response: object { id, createdAt, duplicateId, 4 more }
id: string

Unique identifier for the merge operation.

createdAt: string

ISO 8601 timestamp of when the merge was created.

duplicateId: string

ID of the record that was merged into the primary and soft-deleted.

entityType: string

The object type of the merged records (e.g. account, contact, opportunity, or a custom object slug).

primaryId: string

ID of the record that was kept (the primary).

status: string

Current status of the merge: cleanup_pending, done, or failed.

updatedAt: string

ISO 8601 timestamp of when the merge was last updated.

Get merge status

lightfield merge get-merge \
  --api-key 'My API Key' \
  --id id
{
  "id": "id",
  "createdAt": "createdAt",
  "duplicateId": "duplicateId",
  "entityType": "entityType",
  "primaryId": "primaryId",
  "status": "status",
  "updatedAt": "updatedAt"
}
Returns Examples
{
  "id": "id",
  "createdAt": "createdAt",
  "duplicateId": "duplicateId",
  "entityType": "entityType",
  "primaryId": "primaryId",
  "status": "status",
  "updatedAt": "updatedAt"
}