Per-mailbox warmup metrics
Returns detailed warmup metrics for a specific mailbox including placement breakdown (inbox/spam/promotions/other/not_detected) and daily stats sorted by date ascending.
curl -X GET "https://api.sendkit.ai/v1/warmup/stats/example_string?days=42" \
-H "Content-Type: application/json" \
-H "X-Api-Key: YOUR_API_KEY"
import requests
import json
url = "https://api.sendkit.ai/v1/warmup/stats/example_string?days=42"
headers = {
"Content-Type": "application/json",
"X-Api-Key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.sendkit.ai/v1/warmup/stats/example_string?days=42", {
method: "GET",
headers: {
"Content-Type": "application/json",
"X-Api-Key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api.sendkit.ai/v1/warmup/stats/example_string?days=42", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-Api-Key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.sendkit.ai/v1/warmup/stats/example_string?days=42')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['X-Api-Key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"success": true,
"data": {
"mailbox": {
"id": "664a1b2c3d4e5f6a7b8c9d03",
"email": "sales@mycompany.com",
"displayName": "Sales Team"
},
"warmup": {
"enabled": true,
"status": "in_progress",
"currentDay": 14,
"currentVolume": 25,
"config": {},
"metrics": {},
"startedAt": "2024-05-18T10:00:00.000Z"
},
"totalSent": 350,
"placementBreakdown": {
"inbox": 295,
"spam": 30,
"promotions": 15,
"other": 2,
"not_detected": 8
},
"dailyStats": [
{
"_id": "2024-05-28",
"sent": 25,
"inbox": 22,
"spam": 2,
"replied": 5,
"opened": 20
},
{
"_id": "2024-05-29",
"sent": 25,
"inbox": 21,
"spam": 3,
"replied": 6,
"opened": 19
},
{
"_id": "2024-05-30",
"sent": 25,
"inbox": 23,
"spam": 1,
"replied": 4,
"opened": 22
}
],
"days": 30
}
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
/v1/warmup/stats/{mailboxId}Platform API key (sk_user_...) or Workspace API key (sk_...)
Mailbox ID
Number of days to aggregate stats over (default 30, max 90)
Request Preview
Response
Response will appear here after sending the request
Authentication
API Key for authentication. Platform API key (sk_user_...) or Workspace API key (sk_...)
Path Parameters
Mailbox ID
Query Parameters
Number of days to aggregate stats over (default 30, max 90)
Responses
Full warmup configuration and state from the mailbox
Total warmup emails sent in the period
Email placement counts
Emails where placement could not be determined
Daily breakdown sorted by date ascending
Date in YYYY-MM-DD format
Number of days the stats cover
Last updated 5 days ago
Built with Documentation.AI