GET /v1/mailing/email-message/{uuid}
Recupera lo stato e i dati di tracciamento di un singolo messaggio email.
Panoramica
Usa questo endpoint per ispezionare un singolo messaggio email dopo l'elaborazione.
Restituisce l'oggetto a livello di email, con destinatario, stato di consegna, timestamp, contatori di tracciamento e informazioni sugli errori.
Endpoint
http
GET /v1/mailing/email-message/{uuid}Parametri del percorso
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
uuid | string | Sì | UUID del messaggio email. |
Esempio di richiesta
bash
curl -X GET https://api.mailiqo.com/v1/mailing/email-message/8c2db709-4df2-47c4-b03f-xxxxxxxx \
-H "X-API-KEY: YOUR_API_KEY"Esempio di risposta
json
{
"status": "success",
"data": {
"uuid": "8c2db709-4df2-47c4-b03f-xxxxxxxxx",
"email_message_base_uuid": "ecbc0597-4823-4c9c-9cbb-xxxxxxxx",
"recipient_email": "[email protected]",
"recipient_type": "to",
"status": "delivered",
"validation": {
"checked": true,
"pending": false,
"advanced": true,
"classification": "valid",
"reason": null,
"reason_code": null,
"checked_at": "2026-01-01T10:29:07+00:00"
},
"error_code": null,
"error_message": null,
"created_at": "2026-01-01T10:29:07+00:00",
"submitted_at": "2026-01-01T10:29:07+00:00",
"sent_at": "2026-01-01T10:29:07+00:00",
"delivered_at": "2026-01-01T10:29:07+00:00",
"bounced_at": null,
"complained_at": null,
"rejected_at": null,
"error_at": null,
"failed_at": null,
"first_opened_at": "2026-01-01T11:00:00+00:00",
"last_opened_at": "2026-01-02T17:00:00+00:00",
"first_clicked_at": null,
"last_clicked_at": null,
"opens_count": 2,
"clicks_count": 0
}
}I campi descritti di seguito sono quelli dentro data.
Campi della risposta
| Campo | Tipo | Descrizione |
|---|---|---|
uuid | string | UUID del messaggio email. |
email_message_base_uuid | string | UUID della richiesta di email originale. |
recipient_email | string | Indirizzo email del destinatario. |
recipient_type | string | Tipo di destinatario: to, cc o bcc. |
status | string | Stato attuale del messaggio email. |
validation | object | Risultato della validazione pre-invio. Sempre presente; se non c'è ancora un risultato, checked è false. Vedi Leggere il risultato. |
error_code | string o null | Codice di errore se la consegna è fallita. |
error_message | string o null | Messaggio di errore se la consegna è fallita. |
created_at | string (ISO 8601) | Data e ora di creazione del messaggio email. |
submitted_at | string (ISO 8601) o null | Data e ora in cui l'email è stata inviata all'elaborazione. |
sent_at | string (ISO 8601) o null | Data e ora in cui l'email è stata inviata al provider. |
delivered_at | string (ISO 8601) o null | Data e ora in cui l'email è stata consegnata al destinatario. |
bounced_at | string (ISO 8601) o null | Data e ora del bounce. |
complained_at | string (ISO 8601) o null | Data e ora in cui il destinatario l'ha segnalata. |
rejected_at | string (ISO 8601) o null | Data e ora in cui l'email è stata rifiutata. |
error_at | string (ISO 8601) o null | Data e ora in cui è stato registrato un errore. |
failed_at | string (ISO 8601) o null | Data e ora in cui l'email è fallita. |
first_opened_at | string (ISO 8601) o null | Data e ora della prima apertura. |
last_opened_at | string (ISO 8601) o null | Data e ora dell'ultima apertura. |
first_clicked_at | string (ISO 8601) o null | Data e ora del primo clic. |
last_clicked_at | string (ISO 8601) o null | Data e ora dell'ultimo clic. |
opens_count | integer | Numero totale di aperture dell'email. |
clicks_count | integer | Numero totale di clic sui link dell'email. |
L'oggetto validation
Qui leggi il risultato della validazione dei destinatari. La validazione avanzata avviene durante l'invio, dopo che POST /send ti ha già risposto, quindi questo blocco è l'unico modo per vederla.
| Campo | Tipo | Descrizione |
|---|---|---|
checked | boolean | Un risultato di validazione è già disponibile. |
pending | boolean | È stato segnato per il controllo e l'invio non l'ha ancora validato. |
advanced | boolean | Il controllo ha usato un credito di validazione avanzata. |
classification | string o null | valid, catch_all, risky, unknown o invalid. |
reason | string o null | Motivo leggibile quando il risultato non è valid. |
reason_code | string o null | Codice stabile del motivo. |
checked_at | string (ISO 8601) o null | Data del controllo, non dell'invio: riutilizzare un risultato precedente non la rinnova. |
Quando la validazione scarta un destinatario, status diventa rejected e il motivo compare anche in error_message.
Valori comuni di status
| Stato | Significato |
|---|---|
processing | In attesa di elaborazione. |
submitted | Inviato all'elaborazione. |
sent | Inviato al provider. |
delivery_delayed | Consegna temporaneamente ritardata. |
delivered | Consegnato con successo. |
opened | Aperto dal destinatario. |
clicked | Il destinatario ha cliccato un link. |
bounced | Rifiutato dal server del destinatario. |
complained | Segnalato come spam dal destinatario. |
rejected | Rifiutato dal provider. |
quarantined | Trattenuto per revisione manuale. |
error | Invio fallito per un errore. |
failed | Stato finale di fallimento. |
retry_scheduled | Programmato per un nuovo tentativo. |
Risposte HTTP
| Stato | Significato |
|---|---|
200 | Messaggio email trovato e restituito. |
404 | Messaggio email non trovato. |
500 | Errore interno del server. |
Formato della risposta di errore
json
{
"status": "error",
"error": {
"code": "9999",
"message": "Detailed error message describing the issue."
}
}Note
- Questo endpoint restituisce un singolo messaggio email.
- Una richiesta di invio può generare più record email, a seconda dei destinatari.
- Usa
email_message_base_uuidper ricollegare il messaggio alla richiesta originale.
Endpoint correlati
POST /v1/mailing/sendGET /v1/mailing/email-request/{uuid}
