curl "https://server.smartlead.ai/api/v1/analytics/mailbox/domain-wise-health-metrics?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://server.smartlead.ai/api/v1/analytics/mailbox/domain-wise-health-metrics",
params={"api_key": API_KEY}
)
result = response.json()
print(result)
const API_KEY = 'YOUR_API_KEY';
const response = await fetch(
`https://server.smartlead.ai/api/v1/analytics/mailbox/domain-wise-health-metrics?api_key=${API_KEY}`
);
const result = await response.json();
console.log(result);
{
"ok": true,
"data": {
"domain_health_metrics": [
{
"domain": "example.com",
"sent": 1000,
"opened": 500,
"replied": 60,
"bounced": 10
}
]
}
}
{
"message": "Invalid API Key"
}
{
"error": "Resource not found"
}
{
"error": "Invalid parameters provided"
}
You have exceeded the 10 requests in 60 sec limit for this endpoint!
Global Analytics
Domain-wise Health Metrics
Get performance metrics aggregated by email domain for domain analysis
GET
/
api
/
v1
/
analytics
/
mailbox
/
domain-wise-health-metrics
curl "https://server.smartlead.ai/api/v1/analytics/mailbox/domain-wise-health-metrics?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://server.smartlead.ai/api/v1/analytics/mailbox/domain-wise-health-metrics",
params={"api_key": API_KEY}
)
result = response.json()
print(result)
const API_KEY = 'YOUR_API_KEY';
const response = await fetch(
`https://server.smartlead.ai/api/v1/analytics/mailbox/domain-wise-health-metrics?api_key=${API_KEY}`
);
const result = await response.json();
console.log(result);
{
"ok": true,
"data": {
"domain_health_metrics": [
{
"domain": "example.com",
"sent": 1000,
"opened": 500,
"replied": 60,
"bounced": 10
}
]
}
}
{
"message": "Invalid API Key"
}
{
"error": "Resource not found"
}
{
"error": "Invalid parameters provided"
}
You have exceeded the 10 requests in 60 sec limit for this endpoint!
Query Parameters
string
required
Your SmartLead API key
string
required
Start date (YYYY-MM-DD format)
string
required
End date (YYYY-MM-DD format)
string
IANA timezone string (e.g., “America/New_York”)
string
Comma-separated client IDs
string
Comma-separated campaign IDs
string
Set to “true” to return full data set
string
Max number of results to return
string
Pagination offset
Rate Limit
This endpoint has its own dedicated rate limit of 10 requests per minute, which is separate from your plan’s overall API rate limit.
| Scope | Limit | Window |
|---|---|---|
GET /analytics/mailbox/domain-wise-health-metrics | 10 requests | 60 seconds |
client_ids, campaign_ids or date range you request — every call spends one of the 10.
This limit stacks on top of your plan-wide limit rather than replacing it. Requests here still count toward the account-wide quota described in the Rate Limits guide, so staying under 10/min does not exempt you from that limit, and remaining plan-wide quota does not let you exceed 10/min here.
The window starts on your first request and resets 60 seconds later. Exceeding it returns 429 Too Many Requests with a plain-text body:
429 - Too Many Requests
You have exceeded the 10 requests in 60 sec limit for this endpoint!
This 429 does not include
Retry-After or X-RateLimit-* headers. Wait up to 60 seconds before retrying.full_data=true is the expensive mode — it runs a separate bucketed unique-count query per domain, so a large account can make a single call costly. Request it only when you need the full breakdown, keep start_date/end_date as narrow as your use case allows, and cache the result rather than re-requesting it inside a polling loop.curl "https://server.smartlead.ai/api/v1/analytics/mailbox/domain-wise-health-metrics?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://server.smartlead.ai/api/v1/analytics/mailbox/domain-wise-health-metrics",
params={"api_key": API_KEY}
)
result = response.json()
print(result)
const API_KEY = 'YOUR_API_KEY';
const response = await fetch(
`https://server.smartlead.ai/api/v1/analytics/mailbox/domain-wise-health-metrics?api_key=${API_KEY}`
);
const result = await response.json();
console.log(result);
Response Codes
Success
Request successful
Bad Request
Invalid request parameters or malformed request body
Unauthorized
Invalid or missing API key. Check your authentication.
Not Found
The requested resource (campaign, lead, email account, etc.) does not exist or you don’t have access to it
Validation Error
Request validation failed. Check parameter types, required fields, and value constraints.
Rate Limit Exceeded
You exceeded this endpoint’s dedicated limit of 10 requests per minute, or your plan-wide API rate limit. Wait up to 60 seconds and retry.
Internal Server Error
Server error occurred. Please try again or contact support if the issue persists.
Service Unavailable
API is temporarily unavailable or under maintenance. Please try again later.
{
"ok": true,
"data": {
"domain_health_metrics": [
{
"domain": "example.com",
"sent": 1000,
"opened": 500,
"replied": 60,
"bounced": 10
}
]
}
}
{
"message": "Invalid API Key"
}
{
"error": "Resource not found"
}
{
"error": "Invalid parameters provided"
}
You have exceeded the 10 requests in 60 sec limit for this endpoint!