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ètre | Type | Requis | Description |
|---|---|---|---|
uuid | string | Oui | UUID 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
| Champ | Type | Description |
|---|---|---|
uuid | string | UUID du message. |
email_message_base_uuid | string | UUID de la demande d'envoi d'origine. |
recipient_email | string | Adresse email du destinataire. |
recipient_type | string | Type de destinataire : to, cc ou bcc. |
status | string | Statut actuel du message. |
validation | object | Ré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_code | string ou null | Code d'erreur si la livraison a échoué. |
error_message | string ou null | Message d'erreur si la livraison a échoué. |
created_at | string (ISO 8601) | Horodatage de la création du message. |
submitted_at | string (ISO 8601) ou null | Horodatage de la soumission de l'email au traitement. |
sent_at | string (ISO 8601) ou null | Horodatage de l'envoi de l'email au fournisseur. |
delivered_at | string (ISO 8601) ou null | Horodatage de la livraison de l'email au destinataire. |
bounced_at | string (ISO 8601) ou null | Horodatage du bounce de l'email. |
complained_at | string (ISO 8601) ou null | Horodatage de la plainte du destinataire. |
rejected_at | string (ISO 8601) ou null | Horodatage du rejet de l'email. |
error_at | string (ISO 8601) ou null | Horodatage de l'enregistrement d'une erreur. |
failed_at | string (ISO 8601) ou null | Horodatage de l'échec de l'email. |
first_opened_at | string (ISO 8601) ou null | Horodatage du premier événement d'ouverture. |
last_opened_at | string (ISO 8601) ou null | Horodatage du dernier événement d'ouverture. |
first_clicked_at | string (ISO 8601) ou null | Horodatage du premier événement de clic. |
last_clicked_at | string (ISO 8601) ou null | Horodatage du dernier événement de clic. |
opens_count | integer | Nombre total d'ouvertures de l'email. |
clicks_count | integer | Nombre 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.
| Champ | Type | Description |
|---|---|---|
checked | boolean | Un résultat de validation est déjà disponible. |
pending | boolean | Il a été marqué pour vérification et l'envoi ne l'a pas encore validé. |
advanced | boolean | La vérification a utilisé un crédit de validation avancée. |
classification | string ou null | valid, catch_all, risky, unknown ou invalid. |
reason | string ou null | Motif lisible quand le résultat n'est pas valid. |
reason_code | string ou null | Code stable du motif. |
checked_at | string (ISO 8601) ou null | Date 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
| Statut | Signification |
|---|---|
processing | En attente de traitement. |
submitted | Soumis au traitement. |
sent | Envoyé au fournisseur. |
delivery_delayed | Livraison temporairement retardée. |
delivered | Livré avec succès. |
opened | Ouvert par le destinataire. |
clicked | Un lien a été cliqué par le destinataire. |
bounced | Rejeté par le serveur du destinataire. |
complained | Marqué comme spam par le destinataire. |
rejected | Rejeté par le fournisseur. |
quarantined | Retenu pour revue manuelle. |
error | Échec d'envoi dû à une erreur. |
failed | État d'échec final. |
retry_scheduled | Nouvelle tentative planifiée. |
Réponses HTTP
| Statut | Signification |
|---|---|
200 | Message trouvé et renvoyé. |
404 | Message introuvable. |
500 | Erreur 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_uuidpour relier le message à la demande d'origine.
Endpoints associés
POST /v1/mailing/sendGET /v1/mailing/email-request/{uuid}
