Message endpoints are meant to send and monitor messages sent by the account. Message is a single one to one conversation entity.

A single SMS can contain 160 characters. If the message contains any characters not listed in the 7-bit alphabet, then the message encoding will be set to UCS-2. The message length is limited to 70 characters. Additionally, for long SMS messages exceeding above-mentioned limits, will be supported by splitting them into multiple segments. For WhatsApp and Viber messages the maximum limit of characters is 1024 and 1000 for any character set correspondingly.

Method: Query

Operation to query all messages.

URL /v1/messages
Method Type GET
Authorization API Key
Request Content-Type JSON
Response Content-Type JSON


Name Type Description Status
X-Dexatel-Key string API key Required

Query parameters

Name Type Description Status
page_token string token with encoded pagination details Optional
page_size string number of records to be retrieved Optional
filter[countries] string Optional
filter[sender_ids] string Optional
filter[created_date_start] string Optional
filter[created_date_end] string Optional
filter[direction] string Optional
filter[statuses] string Optional
filter[to] string Optional
filter[from] string Optional
filter[to_prefix] string Optional
filter[channel] string Optional

Request Body


Response Parameters

Name Type Description Status
data array


(see data object below)
pagination object


(see pagination object below)
data object
Name Type Description Status
id string Unique identifier of the message Optional
account_id string Unique identifier of the account Optional
from string Identifier of the sender Optional
to string List of recipients who will receive the message Optional
channel string Delivery channel of the massage.
Possible values:
status string Delivery status of the message.
Possible values:
• scheduled
• enroute
• sent
• received
• delivered
• failed
text string Body of the message Optional
image string Optional
caption string Optional
button object


(see button object below)
schedule string Optional
template_id string Optional
create_date string Creation date of the message in UTC, formatted as yyyyMM-dd HH:mm:ss Optional
update_date string Update date of the message in UTC, formatted as yyyy-MM-dd HH:mm:ss Optional
segments integer The count of message parts Optional
encoding string Encoding of the message. Possible values:
• GSM-7 • UCS-2
sender object


(see sender object below)
direction string Optional
source string Optional
country string Optional
button object
Name Type Description Status
caption string caption description Optional
url string example description Optional
sender object
Name Type Description Status
id string Optional
name string Optional
pagination object
Name Type Description Status
number integer Number of current page Optional
size integer Items count in page Optional
total integer Total count of items Optional
links object


(see links object below)
links object
Name Type Description Status
first string Optional
current string Optional
previous string Optional
next string Optional

Example of request body

GET: /v1/messages
X-Dexatel-Key: 94d2f2f2884848bca861264ad86d8ace

Example of response body

status - 200


Error Codes

The following error codes are returned in response to a user’s request which contains bad syntax or cannot be fulfilled.

Code Description
1501 Message is not found
1502 Invalid message identifier
1503 'data.from' is required
1504 'data.from' is invalid
1505 Message sender is not found
1506 '' is required
1507 '' must be at most [10] items in length
1508 'data.text' is required
1509 'data.text' is invalid
1510 'data.text' is too long
1512 'data.template' is invalid
1513 Template is not found
1514 'data.variables' is required
1515 '' should be in: [SMS, WHATSAPP, VIBER]
1516 One of text, image or template should be specified
1517 Button messages are not supported for whatsapp channel
1518 Image messages are not supported for sms channel
1519 Button messages are not supported for sms channel
1520 'data.button' is required
1521 'data.schedule' is invalid
1522 'data.schedule' should be after current date
1523 Invalid recipient number(s)