Pergunta : Como saber o estado de entrega de um email transacional enviado por API?

Desde setembro de 2026, cada email enviado individualmente pela API (transacional) pode ser seguido até à entrega ao servidor do destinatário.

1. O envio devolve um identificador

POST https://api.mailpro.com/v3/Send/Mail
Authorization: Bearer <o seu token>
→ 200  { "message": "Email queued", "id_single_send": 123456 }

Com a API Email v2, POST /v2/send/sendmail.json devolve igualmente o identificador do envio.

2. Consulte o estado

GET https://api.mailpro.com/v3/Send/123456/Status
Authorization: Bearer <o seu token>
→ 200
{
"id_single_send": 123456,
"email": "[email protected]",
"status": "delivered",
"date_planned": "2026-09-16T08:00:00",
"status_date": "2026-09-16T08:03:41",
"diag_code": "250 2.0.0 OK",
"bounce_type": null
}

Em v2: GET /v2/send/123456/status.json (ou .xml).

Os estados

• queued — aceite, à espera de envio; scheduled — agendado para uma data posterior
• sent — transmitido pelos nossos servidores, sem confirmação do destinatário ainda
• deferred — o servidor do destinatário pede para tentar mais tarde (nós tentamos novamente)
• delivered — aceite pelo servidor do destinatário (diag_code = a sua resposta)
• bounced — rejeitado; bounce_type indica se é definitivo ou temporário
• not_found — identificador desconhecido ou que não pertence à sua conta

O estado delivered aparece cerca de 5 minutos após a entrega. Diz respeito aos envios unitários (API v2, API v3, relay SMTP, automação) — não às campanhas, que têm as suas estatísticas. Os estados são conservados durante 365 dias.

Prefere ser avisado em vez de consultar? Subscreva o evento email.delivered: webhook ou estado, qual escolher?. Referência completa no portal de programadores.