apiId. If your account has a list of allowed IP addresses, the call must come from one of them.propertyName), a value and a comparer: Equals, Contains, GreaterOrEquals or LessOrEquals. The usual filter is campaignId with the id you got when you created the campaign or sent the code. toPhoneNumber and createdAt are useful too. A filter with an unknown field name is ignored.status is Delivered when Viber accepted or delivered the message, Seen when the recipient opened it, Expired when it was not delivered before it expired and SendFailed when the send was refused. toPhoneNumber is written as digits without +, so filter with digits only. For the reason of a failure read the single record (GET /api/partners/viber-data-records/{id}): it carries responseCode and detailedError. This list does not fill them: here responseCode is always 0 and detailedError is null.totalCount is the number of records in this page. To read everything, raise pageNumber until a page comes back with fewer records than pageSize.curl --location 'https://api.veloconnect.me/api/partners/viber-data-records/list' \
--header 'Accept: application/json' \
--header 'apiId: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"pageNumber": 1,
"pageSize": 20,
"filters": [
{
"propertyName": "campaignId",
"value": "1042",
"comparer": "Equals"
}
],
"sortings": [
{
"propertyName": "createdAt",
"direction": "Desc"
}
],
"userId": null
}'{
"data": [
{
"items": [
{
"id": 58232,
"campaignId": 1042,
"from": "MyBrand",
"toPhoneNumber": "37499123456",
"international": false,
"sendDate": "2026-10-08T09:30:04Z",
"price": 0.0146,
"currency": "USD",
"status": "SendFailed",
"message": "Hello Davit, your October offer is ready.",
"actionUrl": null,
"attachmentUrl": null,
"attachmentType": null,
"templateName": "October offer",
"responseCode": 0,
"detailedError": null,
"createdAt": "2026-10-08T09:30:04Z",
"modifiedAt": null
},
{
"id": 58231,
"campaignId": 1042,
"from": "MyBrand",
"toPhoneNumber": "37491234567",
"international": false,
"sendDate": "2026-10-08T09:30:04Z",
"price": 0.0146,
"currency": "USD",
"status": "Seen",
"message": "Hello Anna, your October offer is ready.",
"actionUrl": null,
"attachmentUrl": null,
"attachmentType": null,
"templateName": "October offer",
"responseCode": 0,
"detailedError": null,
"createdAt": "2026-10-08T09:30:04Z",
"modifiedAt": null
}
],
"totalCount": 2,
"pageSize": 20,
"pageNumber": 1
}
]
}