curl --request POST \
--url https://cloudapi.mailercloud.com/v1/campaign/{id}/unsubs \
--header 'Authorization: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"page": 1,
"limit": 25
}
'{
"campaign": {
"name": "May newsletter",
"subject_line": "Big update inside",
"created_date": "2026-05-10 11:30:00"
},
"data": [
{
"contact_id": "SuwESEuwZZ",
"email": "alice@example.com",
"first_name": "Alice",
"last_name": "Anderson",
"tags": [
"VIP"
],
"lists": "SuSwZS",
"list_name": "Newsletter Subscribers",
"created_date": "2026-05-15 09:24:11",
"reason": "no longer interested"
},
{
"contact_id": "SuwESEuHaa",
"email": "bob@example.com",
"first_name": "Bob",
"last_name": "",
"tags": [],
"lists": "no lists",
"list_name": "no lists",
"created_date": "2026-05-15 11:02:47",
"reason": "Abuse"
}
],
"total": 42
}List Campaign Unsubscribes
Get a paginated list of contacts who unsubscribed via a specific campaign.
Each row carries the contact’s encrypted id, email, name, the tags currently assigned to the contact, the lists the contact currently belongs to (with their ids and names), the time of the unsubscribe in your account timezone, and the reason the contact gave (if any).
POST
/
campaign
/
{id}
/
unsubs
curl --request POST \
--url https://cloudapi.mailercloud.com/v1/campaign/{id}/unsubs \
--header 'Authorization: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"page": 1,
"limit": 25
}
'{
"campaign": {
"name": "May newsletter",
"subject_line": "Big update inside",
"created_date": "2026-05-10 11:30:00"
},
"data": [
{
"contact_id": "SuwESEuwZZ",
"email": "alice@example.com",
"first_name": "Alice",
"last_name": "Anderson",
"tags": [
"VIP"
],
"lists": "SuSwZS",
"list_name": "Newsletter Subscribers",
"created_date": "2026-05-15 09:24:11",
"reason": "no longer interested"
},
{
"contact_id": "SuwESEuHaa",
"email": "bob@example.com",
"first_name": "Bob",
"last_name": "",
"tags": [],
"lists": "no lists",
"list_name": "no lists",
"created_date": "2026-05-15 11:02:47",
"reason": "Abuse"
}
],
"total": 42
}Authorizations
Body
application/json