Get Campaign Report: Unsubscribed

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

Get information on the contacts who unsubscribed using a link in the campaign.

Parameters

data (array of structs)

Details of each unsubscribe:

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.

occurred_at (string) When the unsubscribe 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.

200 (success) returns

data (array of structs)

Details of the contacts that unsubscribed:

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.

paging (struct/array)

URLs to navigate the results:

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	The campaign could not be found.
CAMPAIGN_NOT_SENT	The campaign does not have a status of 'SENT'.

API-wide error codes
INVALID_PARAMETERS	Parameters are missing or invalid.
API_KEY_INVALID	Your API key is invalid.
UNAUTHORISED	You're not authorised to perform that action.
NOT_FOUND	The requested endpoint does not exist.
UNKNOWN	An unknown error has occurred.

Example request
/api/1.6/campaigns/00000000-0000-0000-0000-000000000000/reports/unsubscribed?api_key=00000000-0000-0000-0000-000000000000

Example response

Example response
{ "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": "2024-12-10T00:00:00+00:00", "last_updated_at": "2024-12-11T19:36:58+00:00" } , "occurred_at": "2024-12-10T19:36:58+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": "2024-12-10T00:00:00+00:00" } , "occurred_at": "2024-12-10T19:36:58+00:00" } ], "paging": [] }

                        
                            {
                                "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": "2024-12-10T00:00:00+00:00",
    "last_updated_at": "2024-12-11T19:36:58+00:00"
}
,
                                        "occurred_at": "2024-12-10T19:36:58+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": "2024-12-10T00:00:00+00:00"
}
,
                                        "occurred_at": "2024-12-10T19:36:58+00:00"
                                    }
                                ],
                                "paging": []
                            }

Code sample copy
curl -X GET \ https://emailoctopus.com/api/1.6/campaigns/00000000-0000-0000-0000-000000000000/reports/unsubscribed?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/unsubscribed?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/unsubscribed', params=params)
var https = require('https'); var options = { hostname: 'emailoctopus.com', port: 443, path: '/api/1.6/campaigns/00000000-0000-0000-0000-000000000000/reports/unsubscribed?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/unsubscribed?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) } }