Question : How do I know the delivery status of a transactional email sent through the API?

Since September 2026, every email sent individually through the API (transactional) can be followed up to its handover to the recipient's server.

1. The send returns an identifier

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

With the Email API v2, POST /v2/send/sendmail.json likewise returns the identifier of the send.

2. Query the status

GET https://api.mailpro.com/v3/Send/123456/Status
Authorization: Bearer <your 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 (or .xml).

The statuses

• queued — accepted, waiting to be sent; scheduled — planned for a later date
• sent — handed over by our servers, no confirmation from the recipient yet
• deferred — the recipient's server asked us to try again later (we retry)
• delivered — accepted by the recipient's server (diag_code = its answer)
• bounced — rejected; bounce_type says whether it is permanent or temporary
• not_found — unknown identifier or one that does not belong to your account

The delivered status appears about 5 minutes after the handover. It covers single sends (API v2, API v3, SMTP relay, automation) — not campaigns, which have their own statistics. Statuses are kept for 365 days.

Would you rather be notified than poll? Subscribe to the email.delivered event: webhook or status, which one?. Full reference on the developer portal.