Skip to main content

Get senders list

Description

Retrieves a list of senders available for the current account.

Request URL

Method: POST

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

Request parameters

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

Request example

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

Response example

{
"data": [
{
"channel": "email",
"id": 1,
"name": "AKMTA sender",
"type": "akmta"
},
{
"channel": "sms",
"id": 2,
"name": "Bulk SMS sender",
"type": "bulksms_com"
}
],
"error": 0,
"error_text": "Successful operation",
"next_from_id": 4
"total_count": 2
}

Response parameters

ParameterTypeDescription
errorintError code
error_textstringError text
next_from_idintThe index must be passed in the next request to receive another piece of data, until the result output contains 0 history lines
idintSender ID
namestringSender name
typestringSender type
channelstringCommunication channel