Get List

This function would help you to retrieve a contact list and related information from MUMARA using API service request. The following section will explain the process of retrieving a subscriber list from MUMARA, by using a sample API request. 

Required to Submit Json Request


The email that account holder uses to login MUMARA

API Token

The API token user has generated using API Configuration section of MUMARA, also mentioned above.


Method being called (Post)


Path to the API file being called ('http//

Field Details






List ID is required in order to retrieve particular list from MUMARA.

Sample Request

Sample Get List request retrieves list and returns obtained data in Json format.  Sample request for list ID “2” is as follows.

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,'');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 60);
curl_setopt($ch, CURLOPT_HTTPHEADER, array( 'APIToken: 343b1b831067b50e308e6bf93e0f06f0', 'Login: [email protected]'));
$data = curl_exec($ch);
if (curl_errno($ch)) {
   print "Error: " . curl_error($ch);
} else {
   // Show me the result
   print ($data);

Success Response

You will get the following response upon submitting appropriate request and correct ID of the particular list you want to retrieve from MUMARA.

Status value for successfully getting list will be- “success”
Data Returned- List ID, List Name, List Owner Name, List Owner Email, List Bounce Email, List Reply to Email, Number of Subscribers, Date of Creation

{"status":"success","response":[{"list_id":"2","list_name":"Example List","list_owner_name":"Testing Owner","list_owner_email":"[email protected]","list_bounce_email":"","list_reply_email":"[email protected]","contacts":"12","create_date":"2014-11-30"}]}

Erroneous Response

When you submit request with inappropriate, incorrect information.

Status value for unsuccessful submission will be-"error” 
Data Returned- Text based message describing reason of unsuccessful response.