Get Messages
GET
/v1/messages
Authorization
Found in the platform under community settings >** API keys.**
Permission:
Get MessagesParameters
Users
user ID or email to filter the needed user. The response will include the messages send by the provided user in all channels.user ID and emailUser parameter, the response will return for all users in the communityChannel
channel ID to filter for the required channel. The response will include the messages send in the provided channel by all users.channel parameter, the response will return for all channels in the communityUser and channel parameter to get messages send by a particular user in a selected channel.Count
count to filter for the number of messages returned. (Acceted value: 1 - 100)The response will contain the number of messages in the count.
count parameter, the response will return the last 50 messages send.Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.returning.ai/v1/messages?user_id&channel_id&count&email'Response Response Example
200 - Success
{
"status": "success",
"message": "messages fetched successfully",
"data": {
"total": 10,
"messages": [
{
"id": "689b908502ad38f",
"message": "Hi",
"user": {
"user_id": "1243",
"email": "johndoe@gmail.com"
},
"channel": {
"channel_id": "663347f4361726479c6",
"name": "Rules"
},
"timestamp": "2025-08-05T01:39:43.561Z"
},
...
{
"id": "6633473f8a0f479cf",
"message": "Good morning everyone!",
"user": {
"user_id": "1243",
"email": "johndoe@gmail.com"
},
"channel": {
"channel_id": "66334714361726479c6",
"name": "General"
},
"timestamp": "2024-05-02T07:56:47.276Z"
}
]
}
}Modified at 2026-04-07 08:36:22