List emails
Post /blacklists/list
Parameters:
| Name | Description | Type | Mandatory |
|---|---|---|---|
| type |
Type of blacklist. Values available:
|
String | Yes |
| list | Available for unsubscribe and complaints, if you have create a custom list. By default all unsubscribe or complaints will be returned) | String | No |
| pageSize | Number of item returned | Int | No |
| page | Page number | Int | No |
| order | Order of the return (0 (ASC) or 1 (DESC) / based on date value) | Int | No |
Response:
| Name | Description | Type | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| type |
An array with information about each email on blacklist
|
Array | |||||||||||||||
| total | Total of items on the blacklist | Int |
Programming language:
Request exemple:
{
"pageSize": 10,
"page": 1,
"order": 1
}
Response exemple:
{
"bounces": [
{
"email": "email1@example.com",
"date": 1438765958,
"reason": ""
},
{
"email": "email2@example.com",
"date": 1438765958,
"reason": ""
}
],
"total": 200
}
Code example:
curl -d '{"page":1,"pageSize":10}' -H "Content-Type: application/json" -H "X-Tipimail-ApiUser:YOUR_SMTP_USERNAME" -H "X-Tipimail-ApiKey:YOUR_SMTP_KEY" https://api.tipimail.com/v1/blacklists/list/unsubscribers
require 'vendor/autoload.php';
$tipimail = new Tipimail\Tipimail('YOUR_SMTP_USERNAME', 'YOUR_API_KEY');
try {
$list = null;
$pageSize = 2;
$page = 1;
$order =1;
$result = $tipimail->getBlacklistsService()->getBounces($pageSize, $page, $order);
var_dump($result);
$result = $tipimail->getBlacklistsService()->getComplaints($list, $pageSize, $page, $order);
var_dump($result);
$result = $tipimail->getBlacklistsService()->getUnsubscribers($list, $pageSize, $page, $order);
var_dump($result);
}
catch(Tipimail\Exceptions\TipimailException $e) {
echo 'Exception received :', $e->getMessage(), "\n";
}