Summary
Whether this account can send email. object is sending_status. status is active, warning, or paused. reason is null, bounce_rate, or complaint_rate. window_days is 7. sent, bounced, complained, bounce_rate, and complaint_rate use the same trailing 7-day rules as GET /api/v1/metrics/rates with no inbox id: sent counts outbound messages, and bounced and complained count messages whose labels include those names. thresholds lists min_sent (50), warning_bounce_rate (0.05), warning_complaint_rate (0.001), pause_bounce_rate (0.10), pause_min_bounced (5), pause_complaint_rate (0.005), and pause_min_complained (3). Below 50 sent messages the status is active. Warning does not block sends. Paused blocks agent email with HTTP 403 sending_paused until the rate recovers. paused_at is an ISO-8601 timestamp or null. evaluated_at is when this response was computed. resumes says sending resumes automatically when the trailing 7-day rate falls below the pause threshold. Requires message_read. An inbox-scoped key receives the account status, because the pause is account-wide. A key without message_read is 403 permission_denied. A missing or invalid key is 401 unauthorized. A sub-account is evaluated on its own mail. MCP: cooper_get_sending_status.
Request
This call has no JSON body.
Response
HTTP 200. Sample values illustrate the schema.
{
"object": "sending_status",
"status": "active",
"reason": "bounce_rate",
"window_days": 7,
"sent": 1,
"bounced": 1,
"complained": 1,
"bounce_rate": 1,
"complaint_rate": 1,
"thresholds": {
"min_sent": 1,
"warning_bounce_rate": 1,
"warning_complaint_rate": 1,
"pause_bounce_rate": 1,
"pause_min_bounced": 1,
"pause_complaint_rate": 1,
"pause_min_complained": 1
},
"paused_at": "2026-10-18T12:00:00.000Z",
"evaluated_at": "2026-10-18T12:00:00.000Z",
"resumes": "string"
}Errors
- HTTP 403 sending_paused
- HTTP 403 permission_denied
Idempotency
This route does not document Idempotency-Key or client_id.