Skip to main content
GET
/
v1
/
messaging
/
conversations
Retrieve all conversations
curl --request GET \
  --url https://api-staging.respondent.io/v1/messaging/conversations \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-api-secret: <x-api-secret>'
{
  "page": 1,
  "pageSize": 50,
  "results": [
    {
      "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>"
      }
    }
  ],
  "totalResults": 123
}

Headers

​
x-api-key
string
required
​
x-api-secret
string
required

Query Parameters

​
page
number
default:1
​
pageSize
number
default:20
​
includeCount
boolean
default:false
​
externalResearcherId
string

Filter conversations by externalResearcherId.

​
projectId
string<ObjectId>

Filter conversations by projectId.

Response

200 - application/json
​
page
number
default:1
required
​
pageSize
number
default:50
required
​
results
object[]
required
​
totalResults
number

The total number of results possible, which is only provided in the response when includeCount is passed as true within a request.