List Messages by Conversation

POST/v1/messages/by-conversation

Retrieves all messages for a specific conversation.

Body

conversationIdstring required

Example:60f1234567890abcdef12345

pageinteger

Example:1

limitinteger

Example:25

Responses

Body

success_codeenum: 200 | 201•Numeric success code matching the HTTP response status. required

Example:200

messagestring required

Example:OK

detailsobject required

dataarray[object] required

idstring

Example:60f9999997890abcdef12345

conversationIdstring

Example:60f1234567890abcdef12345

contentstring

Example:Hello, how can I help you?

sender_typestring

Example:agent

created_atstring

Example:2026-08-02T18:00:00.000Z

metaobject

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

Request Sample:Shell / cURL

1
2
3
4

curl --request POST \
  --url "https://api-stg.bevatelcloud.com/v1/messages/by-conversation" \
  --header "Authorization: Bearer <YOUR_API_KEY>" \
  --header "Content-Type: application/json"

Response Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
  "success_code": 200,
  "message": "OK",
  "details": {},
  "data": [
    {
      "id": "60f9999997890abcdef12345",
      "conversationId": "60f1234567890abcdef12345",
      "content": "Hello, how can I help you?",
      "sender_type": "agent",
      "created_at": "2026-08-02T18:00:00.000Z"
    }
  ],
  "meta": {}
}