Read a task
curl --request GET \
--url https://{apiBaseUrl}/api/guestprofile/tasks/{task_id} \
--header 'Authorization: Bearer <token>'const url = 'https://{apiBaseUrl}/api/guestprofile/tasks/{task_id}';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://{apiBaseUrl}/api/guestprofile/tasks/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{apiBaseUrl}/api/guestprofile/tasks/{task_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}using RestSharp;
var options = new RestClientOptions("https://{apiBaseUrl}/api/guestprofile/tasks/{task_id}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.get("https://{apiBaseUrl}/api/guestprofile/tasks/{task_id}")
.header("Authorization", "Bearer <token>")
.asString();{
"progress": 100,
"status": "completed",
"result": {
"rid": "guestprofile.entities.8dfd708c-9584-4ed3-8e2c-415afb373a13.guests.55468764-64be-4fc1-a43f-e37239e012bf"
},
"startedAt": "2026-09-18T07:56:08Z",
"endedAt": "2026-09-18T07:56:08Z"
}Merge
Read a task
Follow an asynchronous operation and collect its result
GET
/
api
/
guestprofile
/
tasks
/
{task_id}
Read a task
curl --request GET \
--url https://{apiBaseUrl}/api/guestprofile/tasks/{task_id} \
--header 'Authorization: Bearer <token>'const url = 'https://{apiBaseUrl}/api/guestprofile/tasks/{task_id}';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://{apiBaseUrl}/api/guestprofile/tasks/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{apiBaseUrl}/api/guestprofile/tasks/{task_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}using RestSharp;
var options = new RestClientOptions("https://{apiBaseUrl}/api/guestprofile/tasks/{task_id}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.get("https://{apiBaseUrl}/api/guestprofile/tasks/{task_id}")
.header("Authorization", "Bearer <token>")
.asString();{
"progress": 100,
"status": "completed",
"result": {
"rid": "guestprofile.entities.8dfd708c-9584-4ed3-8e2c-415afb373a13.guests.55468764-64be-4fc1-a43f-e37239e012bf"
},
"startedAt": "2026-09-18T07:56:08Z",
"endedAt": "2026-09-18T07:56:08Z"
}Merging guests and computing a merge confidence both answer with a
location header pointing here. The task path sits outside the entity, so the identifier from the header is the whole address you need.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Identifier of the task, taken from the location header of the operation.
Response
The task
Completion percentage, 100 once the task has ended.
State of the task.
Available options:
pending, running, completed, failed Result of the task, shaped by the operation: a confidence score for a merge confidence computation, an object carrying the resource identifier for a merge.
Reason the task failed. Absent on a completed task.
Was this page helpful?