> ## Documentation Index
> Fetch the complete documentation index at: https://api.smartlead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Warmup Statistics

> Retrieve daily warmup performance statistics for the past 7 days

<Note>
  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.
</Note>

## Path Parameters

<ParamField path="email_account_id" type="number" required>
  The email account ID to retrieve warmup stats for
</ParamField>

## Query Parameters

<ParamField query="api_key" type="string" required>
  Your SmartLead API key
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://server.smartlead.ai/api/v1/email-accounts/123/warmup-stats?api_key=YOUR_KEY"
  ```

  ```python Python theme={null}
  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")
  ```

  ```javascript JavaScript theme={null}
  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`);
    });
  }
  ```
</RequestExample>

## Response Codes

<ResponseField name="200" type="Success">
  Warmup statistics retrieved successfully
</ResponseField>

<ResponseField name="401" type="Unauthorized">
  Invalid or missing API key
</ResponseField>

<ResponseField name="404" type="Not Found">
  Email account not found or you don't have access to it
</ResponseField>

<ResponseField name="500" type="Internal Server Error">
  Server error occurred or warmup service unavailable
</ResponseField>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "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
      }
    ]
  }
  ```

  ```json 401 - Unauthorized theme={null}
  {
    "message": "Invalid API Key"
  }
  ```

  ```json 404 - Not Found theme={null}
  {
    "message": "Email account not found",
    "status": "error"
  }
  ```
</ResponseExample>

## Usage Notes

<Info>
  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.
</Info>

<Tip>
  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
</Tip>

<Warning>
  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
</Warning>

## Related Endpoints

* [Update Warmup Settings](/api-reference/email-accounts/warmup-settings)
* [Get Email Account by ID](/api-reference/email-accounts/get-by-id)
* [Suspend Email Account](/api-reference/email-accounts/suspend)