chatId you need to reply.apiId. If your account has a list of allowed IP addresses, the call must come from one of them.pageNumber (default 1) and pageSize (default 20, at most 1000).fromPhoneNumber and toPhoneNumber: keep only the chats whose first message has this value in from or in to. When you send both, a chat that matches either one is returned.sortings: a list of items with propertyName and direction (Asc or Desc).id is the conversation id for GET /api/partners/viber-conversations/{id}/messages. chatId names the chat when you reply. unreadMessagesCount counts the messages you have not read yet, and lastMessage is the newest message of the chat.curl --location 'https://api.veloconnect.me/api/partners/viber-conversations/list' \
--header 'Accept: application/json' \
--header 'apiId: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"pageNumber": 1,
"pageSize": 20
}'{
"data": [
{
"items": [
{
"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": 1,
"lastMessage": {
"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
}
}
],
"totalCount": 1,
"pageSize": 20,
"pageNumber": 1
}
]
}