GET
/
v1
/
messaging
/
messages
Retrieve all messages
curl --request GET \
  --url https://api-staging.respondent.io/v1/messaging/messages \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-api-secret: <x-api-secret>'
{
  "totalResults": 123,
  "page": 1,
  "pageSize": 50,
  "results": [
    {
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "uid": "<string>",
      "body": "<string>",
      "conversation": {
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "uid": "<string>",
        "name": "<string>",
        "deleted": true,
        "locked": true,
        "read": true,
        "metadata": {
          "projectId": "<string>",
          "surveyResponseId": "<string>",
          "externalResearcherId": "<string>",
          "externalTeamId": "<string>",
          "externalCompanyId": "<string>"
        },
        "participants": [
          {
            "uid": "<string>",
            "foreignId": "<string>",
            "firstName": "<string>",
            "lastName": "<string>",
            "read": true,
            "deleted": true
          }
        ]
      },
      "sender": {
        "uid": "<string>",
        "foreignId": "<string>",
        "firstName": "<string>",
        "lastName": "<string>"
      }
    }
  ]
}

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
conversationUid
string

Filter messages by conversationUid.

externalResearcherId
string

Filter messages by externalResearcherId.

projectId
string<ObjectId>

Filter messages by projectId.

since
string

Get all messages since timestamp.

until
string

Get all messages until timestamp.

Response

200 - application/json

The response is of type object.