Da settembre 2026, ogni email inviata singolarmente tramite l'API (transazionale) può essere seguita fino alla consegna al server del destinatario.
1. L'invio restituisce un identificativo
POST https://api.mailpro.com/v3/Send/Mail
Authorization: Bearer <il vostro token>
→ 200 { "message": "Email queued", "id_single_send": 123456 }Con l'API Email v2, POST /v2/send/sendmail.json restituisce allo stesso modo l'identificativo dell'invio.
2. Interrogate lo stato
GET https://api.mailpro.com/v3/Send/123456/Status
Authorization: Bearer <il vostro 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
}In v2: GET /v2/send/123456/status.json (oppure .xml).
Gli stati
queued— accettata, in attesa di invio;scheduled— programmata per una data successivasent— trasmessa dai nostri server, conferma del destinatario non ancora ricevutadeferred— il server del destinatario chiede di riprovare più tardi (riproviamo noi)delivered— accettata dal server del destinatario (diag_code= la sua risposta)bounced— rifiutata;bounce_typeprecisa se è definitivo o temporaneonot_found— identificativo sconosciuto o non appartenente al vostro account
Lo stato delivered compare circa 5 minuti dopo la consegna. Riguarda gli invii singoli (API v2, API v3, relay SMTP, automazione), non le campagne, che hanno le loro statistiche. Gli stati sono conservati per 365 giorni.
Preferite essere avvisati invece di interrogare? Iscrivetevi all'evento email.delivered: webhook o stato, quale scegliere?. Riferimento completo sul portale sviluppatori.