Skip to main content
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"

{
  "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
    }
  ]
}
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

​
email_account_id
number
required
The email account ID to retrieve warmup stats for

​
Query Parameters

​
api_key
string
required
Your SmartLead API key
curl "https://server.smartlead.ai/api/v1/email-accounts/123/warmup-stats?api_key=YOUR_KEY"

​
Response Codes

​
200
Success
Warmup statistics retrieved successfully
​
401
Unauthorized
Invalid or missing API key
​
404
Not Found
Email account not found or you don’t have access to it
​
500
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
    }
  ]
}

​
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_day temporarily
  • Checking DNS records (SPF, DKIM, DMARC)
  • Reviewing email content quality
  • Contacting support if issues persist