This API helps you access the entire list of existing broadcasts and their corresponding data. From the fetched broadcast list, you get privy to the number of calls made using a particular campaign, the time the call tries to connect to each number in the list, the agents acting for the broadcast, and more.

Sample Request

curl --request GET \
     --url https://api-account-uk.acefone.com/v2/broadcasts \
     --header 'accept: application/json'

📘 Important!

Before we begin, note that the * sign denotes the mandatory variables in each table.

Request Variables (Query Params)

The following parameter is required to fetch lists of broadcasts:

Variable Name	Description	Data Type
limit	number of records to be fetched. Min: 1 max: 100.	String
broadcast_id	Unique ID of the Broadcast.	String
page	page number of which broadcasts need to be fetched.	String

Sample Response

{
  "page": 1,
  "size": 8,
  "limit": 10,
  "broadcast_limit": 10,
  "results": [ 
  {
      "id": "3176",
      "name": "trunk",
      "description": "trunk",
      "destination_type": "ivr",
      "destination_id": "7926",
      "list_id": "5748",
      "list_name": "trunk",
      "timeout": 120,
      "concurrent_limit": 5,
      "caller_id": "+911206891701",
      "time_group_id": null,
      "time_group_name": null,
      "start_date_time": 1596022920,
      "end_date_time": 1596220140,
      "retry": 1,
      "retry_after": 5,
      "product_id": null,
      "product_name": null,
      "sms_notification": {
        "type": "Both",
        "missed_call_template_id": "79074",
        "missed_call_template_name": "Template 9",
        "recieved_call_template_id": "79075",
        "recieved_call_template_name": "Template 10",
        "retry": true
      },
      "status": 0,
      "start_count": 0,
      "created_at": 1596022998,
      "dialstatus": [
        "New",
        "Message Played",
        "DTMF Pressed",
        "No Answer",
        "DND",
        "Busy",
        "Congestion",
        "Failed"
      ]
    },
    {........},
  ]
}

Response Variables

The response returned is as following:

Variable Name	Description	Data Type
limit	number of records to be fetched. Min: 1 max: 100.	Integer
size	number of records fetched.	Integer
page	page number of which broadcasts need to be fetched.	Integer
broadcast_limit	max number of broadcast concurrent limits allowed for the account.	Integer
Result[].id	The unique ID of the broadcast. For example, 9.	String
Result[].name	The name of the broadcast. For example, Campaign 1.	String
Result[].description	The description of the broadcast. For example, Campaign 1 description.	String
Result[].destination_type	Type of destination where the broadcast is directed to. For example, ivr, hangup, etc.	String
Result[].destination_id	Unique ID of the destination.	String
Result[].list_id	The unique ID of the list associated with the broadcast. For example, 70006.	String
Result[].list_name	The name of the lists in the broadcast. For example, Campaign list.	String
Result[].timeout	The time the call tries to connect to each number in the list. For example, Minimum: 10, Maximum: 60.	Integer
Result[].concurrent_limit	The number of channels to be used for broadcast. For example,15.	Integer
Result[].caller_id	Caller ID that is showed to the called party.	String
Result[].time_group_id	Unique ID of the time_group associated with the broadcast.	String
Result[].time_group_name	Name of the time group associated with the broadcast.	String
Result[].start_date_time	Date and time in which leads associated with broadcast are called.	String
Result[].end_date_time	Date and time till which leads associated with broadcast are called.	String
Result[].retry	Specifies Retry count to dial on the dial status other than new.
Result[].retry_after	Time Duration after which the retry will take place.
Result[].product_id	Product ID of the Broadcast product applied on the campaign.
Result[].product_name	Product Name of the Broadcast product applied on the campaign.
Result[].sms_notification.type	Whether SMS is to be triggered for missed, answered or both.
Result[].sms_notification.missed_call_template_id	Template ID of the missed call template.
Result[].sms_notification.missed_call_template_name	Template Name of the missed call template.
Result[].sms_notification.recieved_call_template_id	Template ID of the received call template.
Result[].sms_notification.recieved_call_template_name	Template Name of the received call template.
Result[].sms_notification.retry	If retry is required for SMS.
Result[].status	The current status of the broadcast. For example, The possible values are 0: Inactive, 1: Active, 2: Paused.	Integer
Result[].start_count	Number of times that broadcast has been started.
Result[].created_at	Created Time Stamp of the broadcast.
Result[].dialstatus	Dial Status to dial the call on selected in the campaign.

200200

400400