apiId. If your account has a list of allowed IP addresses, the call must come from one of them.id is the conversation id from POST /api/partners/viber-conversations/list. Reading a page marks its messages as read, so unreadMessagesCount of the conversation goes down.from and to tell the direction of each message: a message from the customer has the customer's number in from, and your own message has the name of your sender in from. If the conversation does not exist or is not yours, the call answers 400 with Conversation is not found.curl --location 'https://api.veloconnect.me/api/partners/viber-conversations/733/messages?PageNumber=1&PageSize=20' \
--header 'Accept: application/json' \
--header 'apiId: <api-key>' \
--header 'Content-Type: application/json'{
"data": [
{
"items": [
{
"id": 741,
"chatId": "3f2b8c1e-5d47-4a9b-9c0e-7a1d2e3f4b5c",
"from": "37491234567",
"to": "MyBrand",
"userName": "Anna Petrosyan",
"type": "Text",
"message": "Can I collect it today?",
"attachmentUrl": null,
"attachmentType": null,
"receivedAt": "2026-10-08T09:42:00Z",
"status": "Seen",
"campaignId": null,
"unreadMessagesCount": 0,
"lastMessage": null
},
{
"id": 733,
"chatId": "3f2b8c1e-5d47-4a9b-9c0e-7a1d2e3f4b5c",
"from": "37491234567",
"to": "MyBrand",
"userName": "Anna Petrosyan",
"type": "Text",
"message": "Hello, is my order ready?",
"attachmentUrl": null,
"attachmentType": null,
"receivedAt": "2026-10-08T09:30:00Z",
"status": "Seen",
"campaignId": null,
"unreadMessagesCount": 0,
"lastMessage": null
}
],
"totalCount": 2,
"pageSize": 20,
"pageNumber": 1
}
]
}