GET https://emailoctopus.com/api/1.6/campaigns/:campaignId/reports/bounced

Get information on the contacts who the campaign was sent to but bounced.

Parameters
api_key (string)
limit (integer)
200 (success) returns
data (array of structs)
contact (struct) Details of the contact:
id (string) The identifier of the contact.
email_address (string) The email address of the contact.
fields (object) An object containing key/value pairs of field values, using the field's tag as the key.
tags (array) An array of tags associated with the contact.
status (string) The status of the contact: SUBSCRIBED, UNSUBSCRIBED or PENDING.
deleted (boolean) If the contact has since been deleted. If true, all other fields apart from id will be NULL.
created_at (string) When the contact was created, in ISO 8601 format.
last_updated_at (string) When the contact was last updated, in ISO 8601 format.
type (string) The type of bounce [HARD/SOFT].
occurred_at (string) When the bounce occurred, in ISO 8601 format.
paging (struct/array) If there is more data available, an object is returned in the following format:
next (string) A link for the immediate next page of results.

If there is no more data to page, an empty array is returned.

Non-200 (error) returns
Details of the error:
code (string) The error code.
message (string) A description of the error.
Method-specific error codes
CAMPAIGN_NOT_FOUND
CAMPAIGN_NOT_SENT
API-wide error codes
INVALID_PARAMETERS
API_KEY_INVALID
UNAUTHORISED
NOT_FOUND
UNKNOWN
Example request
/api/1.6/campaigns/00000000-0000-0000-0000-000000000000/reports/bounced?api_key=00000000-0000-0000-0000-000000000000
Example response
```js
{ 
"data": [  
    {  
        "contact": {  
            "id": "00000000-0000-0000-0000-000000000000",  
            "email_address": "john.doe@example.com",  
            "fields": {  
                "FirstName": "John",  
                "LastName": "Doe",  
                "Birthday": "2000-12-20"  
            },  
            "tags": [  
                "vip"  
            ],  
            "status": "UNSUBSCRIBED",  
            "created_at": "2026-06-14T00:00:00+00:00",  
            "last_updated_at": "2026-06-15T08:25:18+00:00"  
        },  
        "type": "HARD",  
        "occurred_at": "2026-06-14T08:25:18+00:00"  
    },  
    {  
        "contact": {  
            "id": "00000000-0000-0000-0000-000000000001",  
            "email_address": "jane.doe@example.com",  
            "fields": {  
                "FirstName": "Jane",  
                "LastName": "Doe",  
                "Birthday": "2000-12-20"  
            },  
            "tags": [  
                "vip"  
            ],  
            "status": "UNSUBSCRIBED",  
            "created_at": "2026-06-14T00:00:00+00:00"  
        },  
        "type": "SOFT",  
        "occurred_at": "2026-06-14T08:25:18+00:00"  
    }  
],  
"paging": []

} 


| Code sample           |  
|----------------------|  
| cURL                 |  
| ```  
                    curl -X GET \  
    https://emailoctopus.com/api/1.6/campaigns/00000000-0000-0000-0000-000000000000/reports/bounced?api_key=00000000-0000-0000-0000-000000000000
                ```

| ```  
                    $ch = curl_init();  
curl_setopt($ch, CURLOPT_URL, 'https://emailoctopus.com/api/1.6/campaigns/00000000-0000-0000-0000-000000000000/reports/bounced?api_key=00000000-0000-0000-0000-000000000000');  
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);  
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');  
$result = curl_exec($ch);  
if (curl_errno($ch)) {  
    echo 'Error:' . curl_error($ch);  
}  
curl_close($ch);  
                ```

| ```  
                    import requests  
params = (  
    ('api_key', '00000000-0000-0000-0000-000000000000'),  
)  
response = requests.get('https://emailoctopus.com/api/1.6/campaigns/00000000-0000-0000-0000-000000000000/reports/bounced', params=params)  
                ```

| ```  
                    var https = require('https');  
var options = {  
    hostname: 'emailoctopus.com',  
    port: 443,  
    path: '/api/1.6/campaigns/00000000-0000-0000-0000-000000000000/reports/bounced?api_key=00000000-0000-0000-0000-000000000000',  
    method: 'GET',  
};  
var req = https.request(options);  
req.end();  
                ```

| ```  
                    package main  
import (  
    "io/ioutil"  
    "log"  
    "net/http"  
)  
func main() {  
    client := &http.Client{}  
    
    req, err := http.NewRequest("GET", "https://emailoctopus.com/api/1.6/campaigns/00000000-0000-0000-0000-000000000000/reports/bounced?api_key=00000000-0000-0000-0000-000000000000", nil)  
    if err != nil {  
        log.Fatal(err)  
    }  
    
    resp, err := client.Do(req)  
    if err != nil {  
        log.Fatal(err)  
    }  
    bodyText, err := ioutil.ReadAll(resp.Body)  
    if err != nil {  
        log.Fatal(err)  
    }  
}  
                ```