Get Blacklisted Subscribers

Retrieve all subscribers marked as blacklisted within a specific list. Useful for list cleanup, suppression handling, or filtering.

🚫 Get Blacklisted Subscribers

Fetch subscribers who have been flagged as blacklisted in a given list.

---

🔹 HTTP Request

GET API-URL/lists/LIST-UNIQUE-ID/subscribers

---

🔸 URL Segments

Segment	Required	Description
LIST-UNIQUE-ID	Yes	Unique identifier of the subscriber list.

---

🔎 Query Parameters

Parameter	Required / Default	Description
page	1	Page number to retrieve.
per_page	10	Number of subscribers per page.
status	blacklisted	Filters only blacklisted subscribers.

---

🔐 Authorization Header

X-API-KEY: your-api-key-here

---

💻 PHP Example

// Get only the blacklisted subscribers
$response = $endpoint->getBlacklistedSubscribers('LIST-UNIQUE-ID', 'active', $pageNumber = 1, $perPage = 10);

// DISPLAY RESPONSE
echo '<hr /><pre>';
print_r($response->body);
echo '</pre>';

---

📦 Sample JSON Response

{
  "status": "success",
  "data": {
    "count": "3",
    "total_pages": 1,
    "current_page": 1,
    "next_page": null,
    "prev_page": null,
    "records": [
      {
        "subscriber_uid": "zx784mntplq65",
        "EMAIL": "[e-mail]",
        "FNAME": "",
        "LNAME": "",
        "source": "import",
        "status": "blacklisted",
        "ip_address": "",
        "date_added": "2025-04-14 11:05:22"
      },
      {
        "subscriber_uid": "qa119bdxefc91",
        "EMAIL": "[e-mail]",
        "FNAME": "",
        "LNAME": "",
        "source": "import",
        "status": "blacklisted",
        "ip_address": "",
        "date_added": "2025-04-14 11:04:59"
      },
      {
        "subscriber_uid": "wv673xsmnzt43",
        "EMAIL": "[e-mail]",
        "FNAME": "",
        "LNAME": "",
        "source": "import",
        "status": "blacklisted",
        "ip_address": "",
        "date_added": "2025-04-14 11:04:33"
      }
    ]
  }
}