Skip to main content

Get virtual senders list

Description

Retrieves a list of virtual senders.

Request URL

Method: POST

https://example.com/api/v1.1/vsenders/list

Request parameters

ParameterTypeExampleRequiredDescription
tokenstring"abcdefghijklmnqrstuvwxyz"YesAPI token
formatstring"json"NoResponse data format.
By default – json
from_idint1NoThe first virtual sender on the list ID.
By default – 1
limitint2NoVirtual senders list limit.
By default – 1000

Request example

{
"limit": 2,
"token": "abcdefghijklmnqrstuvwxyz"
}

Response example

{
"data": [
{
"email_channel": true,
"id": 1,
"name": "AKMTA virtual sender",
"sms_channel": false
},
{
"email_channel": false,
"id": 2,
"name": "Bulk SMS virtual sender",
"sms_channel": true
}
],
"error": 0,
"error_text": "Successful operation",
"total_count": 2
}

Response parameters

ParameterTypeDescription
errorintError code
error_textstringError text
namestringVirtual sender name
sms_channelbooltrue, if SMS channel is active
email_channelbooltrue, if email channel is active