Skip to content

GET /v1/mailing/email-message/{uuid} ​

Récupérez le statut et les données de suivi d'un message individuel.

Vue d'ensemble ​

Utilisez cet endpoint pour inspecter un seul message après traitement.
Il renvoie l'objet au niveau de l'email, avec le destinataire, le statut de livraison, les horodatages, les compteurs de suivi et les informations d'erreur.

Endpoint ​

http
GET /v1/mailing/email-message/{uuid}

Paramètres de chemin ​

ParamètreTypeRequisDescription
uuidstringOuiUUID du message.

Exemple de requête ​

bash
curl -X GET https://api.mailiqo.com/v1/mailing/email-message/8c2db709-4df2-47c4-b03f-xxxxxxxx \
  -H "X-API-KEY: YOUR_API_KEY"

Exemple de réponse ​

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
  }
}

Les champs décrits ci-dessous sont ceux contenus dans data.

Champs de la réponse ​

ChampTypeDescription
uuidstringUUID du message.
email_message_base_uuidstringUUID de la demande d'envoi d'origine.
recipient_emailstringAdresse email du destinataire.
recipient_typestringType de destinataire : to, cc ou bcc.
statusstringStatut actuel du message.
validationobjectRésultat de la validation avant envoi. Toujours présent ; s'il n'y a pas encore de résultat, checked vaut false. Voir Lire le résultat.
error_codestring ou nullCode d'erreur si la livraison a échoué.
error_messagestring ou nullMessage d'erreur si la livraison a échoué.
created_atstring (ISO 8601)Horodatage de la création du message.
submitted_atstring (ISO 8601) ou nullHorodatage de la soumission de l'email au traitement.
sent_atstring (ISO 8601) ou nullHorodatage de l'envoi de l'email au fournisseur.
delivered_atstring (ISO 8601) ou nullHorodatage de la livraison de l'email au destinataire.
bounced_atstring (ISO 8601) ou nullHorodatage du bounce de l'email.
complained_atstring (ISO 8601) ou nullHorodatage de la plainte du destinataire.
rejected_atstring (ISO 8601) ou nullHorodatage du rejet de l'email.
error_atstring (ISO 8601) ou nullHorodatage de l'enregistrement d'une erreur.
failed_atstring (ISO 8601) ou nullHorodatage de l'échec de l'email.
first_opened_atstring (ISO 8601) ou nullHorodatage du premier événement d'ouverture.
last_opened_atstring (ISO 8601) ou nullHorodatage du dernier événement d'ouverture.
first_clicked_atstring (ISO 8601) ou nullHorodatage du premier événement de clic.
last_clicked_atstring (ISO 8601) ou nullHorodatage du dernier événement de clic.
opens_countintegerNombre total d'ouvertures de l'email.
clicks_countintegerNombre total de clics sur les liens de l'email.

L'objet validation ​

C'est ici que vous lisez le résultat de la validation des destinataires. La validation avancée a lieu pendant l'envoi, après que POST /send vous a déjà répondu, ce bloc est donc le seul moyen de la consulter.

ChampTypeDescription
checkedbooleanUn résultat de validation est déjà disponible.
pendingbooleanIl a été marqué pour vérification et l'envoi ne l'a pas encore validé.
advancedbooleanLa vérification a utilisé un crédit de validation avancée.
classificationstring ou nullvalid, catch_all, risky, unknown ou invalid.
reasonstring ou nullMotif lisible quand le résultat n'est pas valid.
reason_codestring ou nullCode stable du motif.
checked_atstring (ISO 8601) ou nullDate de la vérification, pas de l'envoi : réutiliser un résultat antérieur ne la renouvelle pas.

Quand la validation écarte un destinataire, status devient rejected et le motif apparaît aussi dans error_message.

Valeurs de statut courantes ​

StatutSignification
processingEn attente de traitement.
submittedSoumis au traitement.
sentEnvoyé au fournisseur.
delivery_delayedLivraison temporairement retardée.
deliveredLivré avec succès.
openedOuvert par le destinataire.
clickedUn lien a été cliqué par le destinataire.
bouncedRejeté par le serveur du destinataire.
complainedMarqué comme spam par le destinataire.
rejectedRejeté par le fournisseur.
quarantinedRetenu pour revue manuelle.
errorÉchec d'envoi dû à une erreur.
failedÉtat d'échec final.
retry_scheduledNouvelle tentative planifiée.

Réponses HTTP ​

StatutSignification
200Message trouvé et renvoyé.
404Message introuvable.
500Erreur interne du serveur.

Format de la réponse d'erreur ​

json
{
  "status": "error",
  "error": {
    "code": "9999",
    "message": "Detailed error message describing the issue."
  }
}

Remarques ​

  • Cet endpoint renvoie un message individuel.
  • Une demande d'envoi peut générer plusieurs enregistrements d'email, selon les destinataires.
  • Utilisez email_message_base_uuid pour relier le message à la demande d'origine.

Endpoints associés ​

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

Built with VitePress