Skip to content

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 ​

ParametroTipoObbligatorioDescrizione
uuidstringSì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 ​

CampoTipoDescrizione
uuidstringUUID del messaggio email.
email_message_base_uuidstringUUID della richiesta di email originale.
recipient_emailstringIndirizzo email del destinatario.
recipient_typestringTipo di destinatario: to, cc o bcc.
statusstringStato attuale del messaggio email.
validationobjectRisultato della validazione pre-invio. Sempre presente; se non c'è ancora un risultato, checked è false. Vedi Leggere il risultato.
error_codestring o nullCodice di errore se la consegna è fallita.
error_messagestring o nullMessaggio di errore se la consegna è fallita.
created_atstring (ISO 8601)Data e ora di creazione del messaggio email.
submitted_atstring (ISO 8601) o nullData e ora in cui l'email è stata inviata all'elaborazione.
sent_atstring (ISO 8601) o nullData e ora in cui l'email è stata inviata al provider.
delivered_atstring (ISO 8601) o nullData e ora in cui l'email è stata consegnata al destinatario.
bounced_atstring (ISO 8601) o nullData e ora del bounce.
complained_atstring (ISO 8601) o nullData e ora in cui il destinatario l'ha segnalata.
rejected_atstring (ISO 8601) o nullData e ora in cui l'email è stata rifiutata.
error_atstring (ISO 8601) o nullData e ora in cui è stato registrato un errore.
failed_atstring (ISO 8601) o nullData e ora in cui l'email è fallita.
first_opened_atstring (ISO 8601) o nullData e ora della prima apertura.
last_opened_atstring (ISO 8601) o nullData e ora dell'ultima apertura.
first_clicked_atstring (ISO 8601) o nullData e ora del primo clic.
last_clicked_atstring (ISO 8601) o nullData e ora dell'ultimo clic.
opens_countintegerNumero totale di aperture dell'email.
clicks_countintegerNumero 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.

CampoTipoDescrizione
checkedbooleanUn risultato di validazione è già disponibile.
pendingbooleanÈ stato segnato per il controllo e l'invio non l'ha ancora validato.
advancedbooleanIl controllo ha usato un credito di validazione avanzata.
classificationstring o nullvalid, catch_all, risky, unknown o invalid.
reasonstring o nullMotivo leggibile quando il risultato non è valid.
reason_codestring o nullCodice stabile del motivo.
checked_atstring (ISO 8601) o nullData 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 ​

StatoSignificato
processingIn attesa di elaborazione.
submittedInviato all'elaborazione.
sentInviato al provider.
delivery_delayedConsegna temporaneamente ritardata.
deliveredConsegnato con successo.
openedAperto dal destinatario.
clickedIl destinatario ha cliccato un link.
bouncedRifiutato dal server del destinatario.
complainedSegnalato come spam dal destinatario.
rejectedRifiutato dal provider.
quarantinedTrattenuto per revisione manuale.
errorInvio fallito per un errore.
failedStato finale di fallimento.
retry_scheduledProgrammato per un nuovo tentativo.

Risposte HTTP ​

StatoSignificato
200Messaggio email trovato e restituito.
404Messaggio email non trovato.
500Errore 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_uuid per ricollegare il messaggio alla richiesta originale.

Endpoint correlati ​

  • POST /v1/mailing/send
  • GET /v1/mailing/email-request/{uuid}

Built with VitePress