curl --request POST \
--url https://cloudapi.mailercloud.com/v2/email/inbox-tracking \
--header 'Authorization: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"page": 1,
"limit": 10
}
'{
"status": true,
"message": "requested campaign list",
"data": [
{
"campaign_id": "750373463838949401",
"subject": "Welcome to MailerCloud",
"sent": "10000",
"opens": "4231",
"created_date": "2026-04-15 09:30:00",
"inbox_percentage": 92.5,
"spam_percentage": 5,
"missed_percentage": 2.5,
"providers": [
{
"provider": "gmail.com",
"inbox": "85",
"spam": "10",
"missed": "5"
},
{
"provider": "yahoo.com",
"inbox": "95",
"spam": "3",
"missed": "2"
},
{
"provider": "outlook.com",
"inbox": "90",
"spam": "7",
"missed": "3"
}
],
"test_id": "wyZ",
"placement": {
"test_id": "wyZ",
"status": "running",
"inbox_percentage": 88.5,
"seeds_reported": 52,
"seeds_total": 70
}
}
],
"pagination": {
"current_page": 1,
"per_page_count": 10,
"total_count": 137
}
}{
"status": false,
"message": "requested campaign list",
"errors": [
{
"field": "date_from",
"message": "Date must be in YYYY-MM-DD format"
}
]
}{
"errors": [
{
"field": "",
"message": "Authorization failed"
}
]
}{
"status": false,
"message": "<string>",
"error": "<string>"
}List Inbox-Tracking Campaigns
API to get inbox tracking details for Email API campaigns. Returns a paginated list of campaigns enriched with inbox / spam / missed placement percentages and a per-mailbox-provider breakdown. Supports filtering by campaign id, subject, sender and date range, plus sorting on key metrics.
Sample Code
POST
/
v2
/
email
/
inbox-tracking
curl --request POST \
--url https://cloudapi.mailercloud.com/v2/email/inbox-tracking \
--header 'Authorization: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"page": 1,
"limit": 10
}
'{
"status": true,
"message": "requested campaign list",
"data": [
{
"campaign_id": "750373463838949401",
"subject": "Welcome to MailerCloud",
"sent": "10000",
"opens": "4231",
"created_date": "2026-04-15 09:30:00",
"inbox_percentage": 92.5,
"spam_percentage": 5,
"missed_percentage": 2.5,
"providers": [
{
"provider": "gmail.com",
"inbox": "85",
"spam": "10",
"missed": "5"
},
{
"provider": "yahoo.com",
"inbox": "95",
"spam": "3",
"missed": "2"
},
{
"provider": "outlook.com",
"inbox": "90",
"spam": "7",
"missed": "3"
}
],
"test_id": "wyZ",
"placement": {
"test_id": "wyZ",
"status": "running",
"inbox_percentage": 88.5,
"seeds_reported": 52,
"seeds_total": 70
}
}
],
"pagination": {
"current_page": 1,
"per_page_count": 10,
"total_count": 137
}
}{
"status": false,
"message": "requested campaign list",
"errors": [
{
"field": "date_from",
"message": "Date must be in YYYY-MM-DD format"
}
]
}{
"errors": [
{
"field": "",
"message": "Authorization failed"
}
]
}{
"status": false,
"message": "<string>",
"error": "<string>"
}Authorizations
Body
application/json