Domanda : Come conoscere lo stato di consegna di un'email transazionale inviata via API?

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 successiva
• sent — trasmessa dai nostri server, conferma del destinatario non ancora ricevuta
• deferred — 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_type precisa se è definitivo o temporaneo
• not_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.