curl "https://server.smartlead.ai/api/v1/email-accounts/123/warmup-stats?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
account_id = 123
response = requests.get(
f"https://server.smartlead.ai/api/v1/email-accounts/{account_id}/warmup-stats",
params={"api_key": API_KEY}
)
stats = response.json()
print(f"Total warmup emails sent: {stats.get('total_sent', 0)}")
print(f"Spam count: {stats.get('spam_count', 0)}")
print(f"Daily breakdown:")
for day in stats.get('daily_stats', []):
print(f" {day['date']}: {day['sent']} sent, {day['spam']} spam")
const API_KEY = 'YOUR_API_KEY';
const accountId = 123;
const response = await fetch(
`https://server.smartlead.ai/api/v1/email-accounts/${accountId}/warmup-stats?api_key=${API_KEY}`
);
const stats = await response.json();
console.log(`Total warmup emails sent: ${stats.total_sent || 0}`);
console.log(`Spam count: ${stats.spam_count || 0}`);
// Display daily breakdown
if (stats.daily_stats) {
console.log('Daily breakdown:');
stats.daily_stats.forEach(day => {
console.log(` ${day.date}: ${day.sent} sent, ${day.spam} spam`);
});
}
{
"total_sent": 140,
"spam_count": 3,
"reputation_score": 95,
"daily_stats": [
{
"date": "2025-11-20",
"sent": 15,
"spam": 0,
"delivered": 15,
"opened": 12,
"replied": 4
},
{
"date": "2025-11-21",
"sent": 18,
"spam": 1,
"delivered": 17,
"opened": 14,
"replied": 5
},
{
"date": "2025-11-22",
"sent": 20,
"spam": 0,
"delivered": 20,
"opened": 16,
"replied": 6
}
]
}
{
"message": "Invalid API Key"
}
{
"message": "Email account not found",
"status": "error"
}
Email Account Management
Get Warmup Statistics
Retrieve daily warmup performance statistics for the past 7 days
GET
/
api
/
v1
/
email-accounts
/
{email_account_id}
/
warmup-stats
curl "https://server.smartlead.ai/api/v1/email-accounts/123/warmup-stats?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
account_id = 123
response = requests.get(
f"https://server.smartlead.ai/api/v1/email-accounts/{account_id}/warmup-stats",
params={"api_key": API_KEY}
)
stats = response.json()
print(f"Total warmup emails sent: {stats.get('total_sent', 0)}")
print(f"Spam count: {stats.get('spam_count', 0)}")
print(f"Daily breakdown:")
for day in stats.get('daily_stats', []):
print(f" {day['date']}: {day['sent']} sent, {day['spam']} spam")
const API_KEY = 'YOUR_API_KEY';
const accountId = 123;
const response = await fetch(
`https://server.smartlead.ai/api/v1/email-accounts/${accountId}/warmup-stats?api_key=${API_KEY}`
);
const stats = await response.json();
console.log(`Total warmup emails sent: ${stats.total_sent || 0}`);
console.log(`Spam count: ${stats.spam_count || 0}`);
// Display daily breakdown
if (stats.daily_stats) {
console.log('Daily breakdown:');
stats.daily_stats.forEach(day => {
console.log(` ${day.date}: ${day.sent} sent, ${day.spam} spam`);
});
}
{
"total_sent": 140,
"spam_count": 3,
"reputation_score": 95,
"daily_stats": [
{
"date": "2025-11-20",
"sent": 15,
"spam": 0,
"delivered": 15,
"opened": 12,
"replied": 4
},
{
"date": "2025-11-21",
"sent": 18,
"spam": 1,
"delivered": 17,
"opened": 14,
"replied": 5
},
{
"date": "2025-11-22",
"sent": 20,
"spam": 0,
"delivered": 20,
"opened": 16,
"replied": 6
}
]
}
{
"message": "Invalid API Key"
}
{
"message": "Email account not found",
"status": "error"
}
Returns warmup email statistics for the last 7 days including emails sent, spam count, and daily performance metrics. Use this to monitor warmup progress and reputation building.
Path Parameters
number
required
The email account ID to retrieve warmup stats for
Query Parameters
string
required
Your SmartLead API key
curl "https://server.smartlead.ai/api/v1/email-accounts/123/warmup-stats?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
account_id = 123
response = requests.get(
f"https://server.smartlead.ai/api/v1/email-accounts/{account_id}/warmup-stats",
params={"api_key": API_KEY}
)
stats = response.json()
print(f"Total warmup emails sent: {stats.get('total_sent', 0)}")
print(f"Spam count: {stats.get('spam_count', 0)}")
print(f"Daily breakdown:")
for day in stats.get('daily_stats', []):
print(f" {day['date']}: {day['sent']} sent, {day['spam']} spam")
const API_KEY = 'YOUR_API_KEY';
const accountId = 123;
const response = await fetch(
`https://server.smartlead.ai/api/v1/email-accounts/${accountId}/warmup-stats?api_key=${API_KEY}`
);
const stats = await response.json();
console.log(`Total warmup emails sent: ${stats.total_sent || 0}`);
console.log(`Spam count: ${stats.spam_count || 0}`);
// Display daily breakdown
if (stats.daily_stats) {
console.log('Daily breakdown:');
stats.daily_stats.forEach(day => {
console.log(` ${day.date}: ${day.sent} sent, ${day.spam} spam`);
});
}
Response Codes
Success
Warmup statistics retrieved successfully
Unauthorized
Invalid or missing API key
Not Found
Email account not found or you don’t have access to it
Internal Server Error
Server error occurred or warmup service unavailable
{
"total_sent": 140,
"spam_count": 3,
"reputation_score": 95,
"daily_stats": [
{
"date": "2025-11-20",
"sent": 15,
"spam": 0,
"delivered": 15,
"opened": 12,
"replied": 4
},
{
"date": "2025-11-21",
"sent": 18,
"spam": 1,
"delivered": 17,
"opened": 14,
"replied": 5
},
{
"date": "2025-11-22",
"sent": 20,
"spam": 0,
"delivered": 20,
"opened": 16,
"replied": 6
}
]
}
{
"message": "Invalid API Key"
}
{
"message": "Email account not found",
"status": "error"
}
Usage Notes
Statistics are automatically aggregated for the last 7 days from the current date. The endpoint provides a snapshot of recent warmup performance to help you assess sender reputation progress.
Monitor these key metrics:
- Spam count should remain very low (< 2% of total sent)
- Reputation score should steadily increase toward 90-100
- Reply count indicates healthy engagement with warmup emails
If spam count is high or reputation is declining, consider:
- Reducing
total_warmup_per_daytemporarily - Checking DNS records (SPF, DKIM, DMARC)
- Reviewing email content quality
- Contacting support if issues persist
