Get All Bounces

Retrieve all bounce reports (hard and soft) related to a specific campaign using its unique identifier.

📬 Get All Bounces

Use this endpoint to fetch the list of bounced emails for a particular campaign.


🔹 HTTP Request

GET API-URL/campaigns/CAMPAIGN-UNIQUE-ID/bounces

🔸 URL Segments

Segment
Required
Description

CAMPAIGN-UNIQUE-ID

Yes

Campaign unique ID to retrieve the bounces.


🧾 Query Parameters

Parameter
Default
Description

page

1

Current page to retrieve.

per_page

10

Items per page to retrieve.


🔐 Authorization Header

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

💻 PHP Example

// GET ALL ITEMS
$response = $endpoint->getBounces('CAMPAIGN-UNIQUE-ID', $pageNumber = 1, $perPage = 10);

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

📦 Sample JSON Response

{
  "status": "success",
  "data": {
    "count": "1",
    "total_pages": 1,
    "current_page": 1,
    "next_page": null,
    "prev_page": null,
    "records": [
      {
        "message": "5.1.1 : Recipient address rejected: User unknown in virtual mailbox table",
        "processed": "no",
        "bounce_type": "hard",
        "subscriber": {
          "subscriber_uid": "mn382plq98zr7",
          "email": "[email protected]"
        }
      }
    ]
  }
}

Last updated