curl --request POST \
--url https://cloudapi.mailercloud.com/v1/domains/search \
--header 'Authorization: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"limit": 10,
"page": 1
}
'
{
"data": [
{
"id": "zjAKXb",
"domain": "example.com",
"status": "verified",
"open_tracking": false,
"created_at": "2026-10-13T09:43:00Z"
},
{
"id": "ZZaSaZ",
"domain": "news.example.com",
"status": "not_verified",
"open_tracking": false,
"created_at": "2026-10-12T14:58:14Z"
}
],
"count": 2
}
List Domains
List the sending domains in your account with their status — the same domains and statuses as Account Settings → Domains in the app.
Filter by status to find the domains that still need DNS work, and search by name.
Domain status:
verified— the domain is authenticated and ready to send.not_verified— the DNS records are not all in place yet (or not checked yet).failed— at least one DNS record was found but is wrong (see the record’serror_messagein Get a Domain).
POST
/
domains
/
search
curl --request POST \
--url https://cloudapi.mailercloud.com/v1/domains/search \
--header 'Authorization: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"limit": 10,
"page": 1
}
'
{
"data": [
{
"id": "zjAKXb",
"domain": "example.com",
"status": "verified",
"open_tracking": false,
"created_at": "2026-10-13T09:43:00Z"
},
{
"id": "ZZaSaZ",
"domain": "news.example.com",
"status": "not_verified",
"open_tracking": false,
"created_at": "2026-10-12T14:58:14Z"
}
],
"count": 2
}
Authorizations
Your Mailercloud API key (plain text, no Bearer prefix). Create keys in Settings → API.
Headers
Request body type
Body
application/json
Page number.
Starts From: 1
Required range:
x >= 1Number of domains per page.
Minimum: 10 Maximum: 100
Required range:
10 <= x <= 100Part of the domain name. Not case sensitive.
Maximum string length:
255Only return domains with this status.
Available options:
verified, not_verified, failed Sort by this field.
Default: created_at
Available options:
created_at, domain Sort order.
Default: desc (newest first)
Available options:
asc, desc