Skip to main content
GET
/
v2
/
tasks
/
person-merges
/
{taskId}
Get Person Merge Task
curl --request GET \
  --url https://api.affinity.co/v2/tasks/person-merges/{taskId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "456e7890-e12b-34c5-d678-901234567890",
  "status": "in-progress",
  "resultsSummary": {
    "total": 1,
    "inProgress": 1,
    "success": 0,
    "failed": 0
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
taskId
string<uuid>
required

Person merge task ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

Response

OK

Person merge task details and status for batch operations

​
id
string<uuid>
required

The unique identifier for this merge task

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
status
enum<string>
required

The current status of the batch operation

Available options:
in-progress,
success,
failed
Example:

"in-progress"

​
resultsSummary
object
required

Summary of merges in this batch task