List messages in session

GET

/domains/{domain}/users/{user}/messagesessions/{messagesession}/messages

Last modified:2026-10-09 00:40:37

OperationId:GetMessagesForMessagesession

Returns the messages of one session, newest first. Every scope reaches its own user. Office Manager reaches every user in its domain, Reseller the domains in its territory, and Super User every domain.

The user must have the session: for a session ID the user does not have, the answer is an empty array. For a video meeting chat, a user-level scope reads it only when your token's user is an attendee of that meeting; otherwise the answer is an empty array too. Messages from before the user's messagesession-start-datetime, such as those before a delete, are not returned. limit defaults to 100, and 0 returns every message.

A message with a file carries file-access-url, a signed link that expires. timestamp is UTC in the form YYYY-MM-DD HH:MM:SS.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

The messages. An empty array when none match or the user does not have the session.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠420Rate Limit Exceeded

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//messagesessions/b1946ac92492d2347c6235b4d2611184/messages?limit=undefined&start=undefined&order=timestamp%20asc&messagesession-start-datetime=2026-09-01%2014%3A00%3A00&id=m-66f1c2a4b3d5e' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Chat messages

[
    {
        "id": "m-66f1c2b9c0a17",
        "timestamp": "2026-09-01 14:31:12",
        "type": "chat",
        "domain": "example.com",
        "direction": "term",
        "from-number": "",
        "from-user-id": "1002@example.com",
        "from-video-attendee-id": null,
        "from-user-agent": "Mozilla/5.0",
        "dialed": "",
        "text": "Yes, I can.",
        "terminating-user-id": "1001@example.com",
        "terminating-number": "",
        "status": "sending",
        "meeting-instance-id": null,
        "media-type": "",
        "media-size": 0,
        "deleted-datetime": null,
        "messagesession-receiver-hostname": "core1.example.com",
        "messagesession-id": "b1946ac92492d2347c6235b4d2611184",
        "messagesession-participants": ""
    },
    {
        "id": "m-66f1c2a4b3d5e",
        "timestamp": "2026-09-01 14:30:00",
        "type": "chat",
        "domain": "example.com",
        "direction": "term",
        "from-number": "",
        "from-user-id": "1001@example.com",
        "from-video-attendee-id": null,
        "from-user-agent": "Mozilla/5.0",
        "dialed": "",
        "text": "Can you cover the front desk at 3?",
        "terminating-user-id": "1002@example.com",
        "terminating-number": "",
        "status": "sending",
        "meeting-instance-id": null,
        "media-type": "",
        "media-size": 0,
        "deleted-datetime": null,
        "messagesession-receiver-hostname": "core1.example.com",
        "messagesession-id": "b1946ac92492d2347c6235b4d2611184",
        "messagesession-participants": ""
    }
]

Modified at 2026-10-09 00:40:37

List message sessions

Leave message session