Retrieve specific conversation
Retrieve a single conversation by UID, including its participants and metadata.
curl --request GET \
--url https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid} \
--header 'x-api-key: <x-api-key>' \
--header 'x-api-secret: <x-api-secret>'import requests
url = "https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}"
headers = {
"x-api-key": "<x-api-key>",
"x-api-secret": "<x-api-secret>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-api-key': '<x-api-key>', 'x-api-secret': '<x-api-secret>'}
};
fetch('https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <x-api-key>",
"x-api-secret: <x-api-secret>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("x-api-secret", "<x-api-secret>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}")
.header("x-api-key", "<x-api-key>")
.header("x-api-secret", "<x-api-secret>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
request["x-api-secret"] = '<x-api-secret>'
response = http.request(request)
puts response.read_body{
"createdAt": "<string>",
"uid": "<string>",
"name": "<string>",
"deleted": true,
"locked": true,
"read": true,
"user": {
"uid": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"foreignId": "<string>"
},
"participants": [
{
"uid": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"read": true,
"deleted": true,
"foreignId": "<string>"
}
],
"messages": [
{
"createdAt": "<string>",
"uid": "<string>",
"body": "<string>",
"sender": {
"uid": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"foreignId": "<string>"
},
"updatedAt": "<string>"
}
],
"latestMessage": {
"createdAt": "<string>",
"uid": "<string>",
"body": "<string>",
"updatedAt": "<string>"
},
"messagesCount": 123,
"updatedAt": "<string>",
"metadata": {
"projectId": "<string>",
"surveyResponseId": "<string>",
"externalResearcherId": "<string>",
"externalTeamId": "<string>",
"externalCompanyId": "<string>"
}
}Path Parameters
Response
Unique identifier of conversation.
Name of conversation.
If conversation is marked as deleted.
If conversation is locked.
User who created the conversation. This will be the API owner/admin account for the api team. First name and last name will belong to api team user, not external researcher name. External researcherId will be stored in metadata, which can be used to lookup your external researcher's info internally.
All participants of conversation including the researcher. The researcher will be the API owner/admin account for the api team.
Hide child attributes
Hide child attributes
Unique identifier for messaging user.
First name of user.
Last name initial of user.
Whether the participant has read the conversation.
Whether the participant has muted the conversation.
UserId of messaging user.
All messages in conversation.
Hide child attributes
Hide child attributes
Unique identifier of message.
Body of message.
Count of messages in conversation.
Metadata of conversation.
Hide child attributes
Hide child attributes
ProjectId of the project the coversation belongs to.
ScreenerResponseId for the project, if exists.
ExternalResearcherId for the project, if exists.
ExternalTeamId for the project, if exists.
ExternalCompanyId for the project, if exists.
Was this page helpful?
curl --request GET \
--url https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid} \
--header 'x-api-key: <x-api-key>' \
--header 'x-api-secret: <x-api-secret>'import requests
url = "https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}"
headers = {
"x-api-key": "<x-api-key>",
"x-api-secret": "<x-api-secret>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-api-key': '<x-api-key>', 'x-api-secret': '<x-api-secret>'}
};
fetch('https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <x-api-key>",
"x-api-secret: <x-api-secret>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("x-api-secret", "<x-api-secret>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}")
.header("x-api-key", "<x-api-key>")
.header("x-api-secret", "<x-api-secret>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-staging.respondent.io/v1/messaging/conversations/{conversationUid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
request["x-api-secret"] = '<x-api-secret>'
response = http.request(request)
puts response.read_body{
"createdAt": "<string>",
"uid": "<string>",
"name": "<string>",
"deleted": true,
"locked": true,
"read": true,
"user": {
"uid": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"foreignId": "<string>"
},
"participants": [
{
"uid": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"read": true,
"deleted": true,
"foreignId": "<string>"
}
],
"messages": [
{
"createdAt": "<string>",
"uid": "<string>",
"body": "<string>",
"sender": {
"uid": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"foreignId": "<string>"
},
"updatedAt": "<string>"
}
],
"latestMessage": {
"createdAt": "<string>",
"uid": "<string>",
"body": "<string>",
"updatedAt": "<string>"
},
"messagesCount": 123,
"updatedAt": "<string>",
"metadata": {
"projectId": "<string>",
"surveyResponseId": "<string>",
"externalResearcherId": "<string>",
"externalTeamId": "<string>",
"externalCompanyId": "<string>"
}
}