Get broadcast information

Description

Retrieves detailed information about a broadcast mailing.

Request URL

Method: POST

https://example.com/api/v1.1/campaigns/broadcasts/get

Request parameters

Parameter	Type	Example	Required	Description
token	string	"abcdefghijklmnqrstuvwxyz"	Yes	API token
id	int	11768	Yes	Mailing ID
format	string	"json"	No	Response data format. By default – json

Request example

JSON

{
  "token": "abcdefghijklmnqrstuvwxyz",
  "id": "87"
}

XML

<xml>
  <token>abcdefghijklmnqrstuvwxyz</token>
  <id>87</id>
</xml>

Response example

JSON

{
    "data": {
        "name": "sms ",
        "is_active": false,
        "data_id": 13,
        "data_type": "segment",
        "content": [
            {
                "subject": "",
                "from_email": "",
                "from_name": "",
                "replyto_email": "",
                "replyto_name": "",
                "message_id": 27
            }
        ],
        "send_channel": "sms",
        "channel": "sms",
        "push_sending_mode": "fanout",
        "resource_id": 36,
        "subid": "",
        "limit": 0,
        "aglimit_count": 0,
        "aglimit_percent": 0,
        "start_schedule": {
            "start_mins": [
                38
            ],
            "start_hours": [
                16
            ],
            "start_mdays": [],
            "start_wdays": [],
            "start_months": [],
            "start_years": [],
            "tz": "",
            "profile": false,
            "losers": false
        },
        "for_confirm": false,
        "policy_id": 0,
        "description": "",
        "virtual_sender_id": 0,
        "is_random_tracking_prefix": false,
        "custom_tracking_domains": [],
        "watcher_list_id": 0,
        "watcher_limit": 0,
        "blind_carbon_copy": [],
        "unconditional_sending": false,
        "skip_unique_checking": false,
        "sub_cats_filter": null,
        "sub_fields_filter": null,
        "id": 179,
        "updated_user": "roman",
        "update_time": "2024-05-28T13:40:57.3Z"
    },
    "error": 0,
    "error_text": "Successful operation"
}

XML

<xml>
    <data>
        <aglimit_count>0</aglimit_count>
        <aglimit_percent>0</aglimit_percent>
        <blind_carbon_copy/>
        <channel>"sms"</channel>
        <content>
            <from_email>""</from_email>
            <from_name>""</from_name>
            <message_id>27</message_id>
            <replyto_email>""</replyto_email>
            <replyto_name>""</replyto_name>
            <subject>""</subject>
        </content>
        <custom_tracking_domains/>
        <data_id>13</data_id>
        <data_type>"segment"</data_type>
        <description>""</description>
        <for_confirm>false</for_confirm>
        <id>179</id>
        <is_active>false</is_active>
        <is_random_tracking_prefix>false</is_random_tracking_prefix>
        <limit>0</limit>
        <name>"sms "</name>
        <policy_id>0</policy_id>
        <push_sending_mode>"fanout"</push_sending_mode>
        <resource_id>36</resource_id>
        <send_channel>"sms"</send_channel>
        <skip_unique_checking>false</skip_unique_checking>
        <start_schedule>
            <losers>false</losers>
            <profile>false</profile>
            <start_hours>16</start_hours>
            <start_mdays/>
            <start_mins>38</start_mins>
            <start_months/>
            <start_wdays/>
            <start_years/>
            <tz>""</tz>
        </start_schedule>
        <sub_cats_filter/>
        <sub_fields_filter/>
        <subid>""</subid>
        <unconditional_sending>false</unconditional_sending>
        <update_time>"2024-05-28T13:40:57.3Z"</update_time>
        <updated_user>"roman"</updated_user>
        <virtual_sender_id>0</virtual_sender_id>
        <watcher_limit>0</watcher_limit>
        <watcher_list_id>0</watcher_list_id>
    </data>
    <error>0</error>
    <error_text>Successful operation</error_text>
</xml>

Response parameters

Parameter	Type	Description
error	int	Error code
error_text	string	Error text
id	int	Mailing ID
name	string	Mailing name
is_active	bool	Mailing active flag
resource_id	int	Resource ID
data_id	int	Audience source ID
data_type	string	Audience source type
content	JSON array	Message template object
send_channel	string	Sending channel
channel	string	Channel
for_confirm	bool	Messages with opt-in link flag
subid	string	Mailing SubID
start_schedule	JSON object	Start schedule object
limit	int	Mailing cycle limitation
aglimit_count	int	Increase limit each cycle - number
agllimit_percent	float	Increase limit each cycle - percent
policy_id	int	Sending policy ID
push_sending_mode	string	Push notification sending mode (push channels only)
descr	string	Mailing description
attributes	object	Assigned attributes and their values
Smart settings
virtual_sender_id	int	Virtual sender ID (Smart accounts)
is_random_tracking_prefix	bool	Random tracking domain prefix (Smart accounts)
custom_tracking_domains	JSON array	Tracking domains list (Smart accounts)
blind_carbon_copy	JSON array	Hidden copy email addresses (Smart accounts)
unconditional_sending	bool	Send messages regardless of subscription status (Smart accounts)
watcher_list_id	int	Mailing watchers database ID (Smart accounts)
watcher_limit	int	Watchers limit (Smart accounts)