1. References
  2. Management API
  3. CallLists
Rate this page:

CallLists

Methods

CreateCallList

Copy URL

Adds a new CSV file for call list processing and starts the specified rule immediately. To send a file, use the request body. To set the call time constraints, use the following options in a CSV file:

  • __start_execution_time – when the call list processing will start every day, UTC+0 24-h format: HH:mm:ss
  • __end_execution_time – when the call list processing will stop every day, UTC+0 24-h format: HH:mm:ss
  • __start_at – when the call list processing will start, UNIX timestamp. If not specified, the processing will start immediately after a method call

This method accepts CSV files with custom delimiters, such a commas (,), semicolons (;) and other. To specify a delimiter, pass it to the delimiter parameter.
IMPORTANT: the account's balance should be equal or greater than 1 USD. If the balance is lower than 1 USD, the call list processing won't start, or it stops immediately if it was active.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
Call list manager
CreateCallList example
Copy

CreateCallList example

Add a new CSV file.

Parameters

  • rule_id:

    number

    The rule ID. It's specified in the Applications section of the Control Panel

  • priority:

    number

    Call list priority. The value is in the range of [0 … 2^31] where zero is the highest priority

  • max_simultaneous:

    number

    Number of simultaneously processed tasks

  • num_attempts:

    number

    Number of attempts. Minimum is 1, maximum is 5

  • name:

    string

    File name, up to 255 characters and can't contain the '/' and '\' symbols

  • file_content:

    string

    Send as "body" part of the HTTP request or as multiform. The sending "file_content" via URL is at its own risk because the network devices tend to drop HTTP requests with large headers

  • interval_seconds:

    number

    Optional

    Interval between call attempts in seconds. The default is 0

  • encoding:

    string

    Optional

    Encoding file. The default is UTF-8

  • delimiter:

    string

    Optional

    Separator values. The default is ';'

  • escape:

    string

    Optional

    Escape character for parsing csv

  • reference_ip:

    string

    Optional

    Specifies the IP from the geolocation of the call list subscribers. It allows selecting the nearest server for serving subscribers

Returns

  • result:

    boolean

    true

  • count:

    number

    The number of stored records

  • list_id:

    number

    The list ID

AppendToCallList

Copy URL

Appending a new task to the existing call list.
This method accepts CSV files with custom delimiters, such a commas (,), semicolons (;) and other. To specify a delimiter, pass it to the delimiter parameter.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
Call list manager
AppendToCallList example
Copy

AppendToCallList example

Append new tasks to existing call list.

Parameters

  • list_id:

    number

    The call list ID

  • list_name:

    string

    The unique name of the call list. Can be used instead of list_id

  • file_content:

    string

    Send as request body or multiform

  • encoding:

    string

    Optional

    Encoding file. The default is UTF-8

  • escape:

    string

    Optional

    Escape character for parsing csv

  • delimiter:

    string

    Optional

    Separator values. The default is ';'

Returns

  • result:

    boolean

    true

  • count:

    number

    The number of stored records

  • list_id:

    number

    The list ID

GetCallLists

Copy URL

Get all call lists for the specified user.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
Supervisor
Call list manager
Support
GetCallLists example
Copy

GetCallLists example

Get all lists registered by user.

Parameters

  • list_id:

    intlist

    Optional

    The list ID to filter. Can be a list separated by semicolon (;). Use the 'all' value to select all lists

  • name:

    string

    Optional

    Find call lists by name

  • is_active:

    boolean

    Optional

    Find only active call lists

  • from_date:

    timestamp

    Optional

    The UTC 'from' date filter in 24-h format: YYYY-MM-DD HH:mm:ss

  • to_date:

    timestamp

    Optional

    The UTC 'to' date filter in 24-h format: YYYY-MM-DD HH:mm:ss

  • type_list:

    string

    Optional

    The type of the call list. The possible values are AUTOMATIC and MANUAL

  • count:

    number

    Optional

    The max returning record count

  • offset:

    number

    Optional

    The first N records will be skipped in the output

  • application_id:

    intlist

    Optional

    The application ID to filter. Can be a list separated by semicolon (;). Use the 'all' value to select all applications

Returns

  • result:

    [CallListType]

    Array of lists

  • count:

    number

    The returned call list count

  • total_count:

    number

    The total found call list count

GetCallListDetails

Copy URL

Get details of the specified call list. Returns a CSV file by default.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
Call list manager
sys.Admin read only
GetCallListDetails example
Copy

GetCallListDetails example

Get all lists registered by user.

Parameters

  • list_id:

    number

    The list ID

  • count:

    number

    Optional

    Maximum number of entries in the result

  • offset:

    number

    Optional

    The first N records will be skipped in the output

  • output:

    string

    Optional

    Output format (CSV/JSON/XLS). Default CSV

  • encoding:

    string

    Optional

    Encoding of the output file. Default UTF-8

  • delimiter:

    string

    Optional

    Separator values. The default is ';'

Returns

StopCallListProcessing

Copy URL

Stop processing the specified call list.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
Call list manager
Support
StopCallListProcessing example
Copy

StopCallListProcessing example

Cancel list with id = 1.

Parameters

  • list_id:

    number

    The list Id

Returns

  • result:

    boolean

    true

  • msg:

    string

    Result message

RecoverCallList

Copy URL

Resume processing the specified call list.

Available for roles

To call this method, make sure your service account has one of the following roles:

See Available Roles
Owner
Admin
Developer
Call list manager
RecoverCallList example
Copy

RecoverCallList example

Restore list with id = 1.

Parameters

  • list_id:

    number

    The list Id

Returns

  • result:

    boolean

    true

  • count_recovery:

    number

    Number restored tasks