GET /mailing/email-request/{uuid}
Récupérez le statut de base et les détails d'une demande d'envoi.
Vue d'ensemble
Utilisez cet endpoint pour inspecter la demande d'envoi d'origine une fois créée.
Il renvoie l'objet email_request, qui représente la demande de base et les informations traitées sur ses destinataires.
Endpoint
GET /mailing/email-request/{uuid}Paramètres de chemin
| Paramètre | Type | Requis | Description |
|---|---|---|---|
uuid | string | Oui | UUID de la demande d'envoi. |
Exemple de requête
curl -X GET https://api.mailiqo.com/v1/mailing/email-request/2b687f6a-7e85-4c14-8b17-xxxxxxx \
-H "X-API-KEY: YOUR_API_KEY"Structure de la réponse
La réponse est enveloppée dans {status, data}, et data contient l'objet email_request.
⚠️ Cet endpoint renvoie l'objet au niveau de la demande, pas l'enregistrement d'un email livré individuellement. La différence est que l'objet email_request contient les informations de la demande d'origine, tandis que l'objet email_message représente le message traité envoyé à un seul destinataire. Chaque email_request peut générer plusieurs enregistrements email_message s'il y a plusieurs destinataires.
Champs de email_request
| Champ | Type | Description |
|---|---|---|
uuid | string | UUID de la demande d'envoi. |
status | string | Statut actuel de la demande |
total_recipients | integer | Nombre total de destinataires de la demande. |
domain | string | Domaine d'envoi. |
from_email | string | Adresse email de l'expéditeur d'origine. |
subject | string | Objet d'origine de l'email. |
email_messages | array | Liste des UUID des messages générés à partir de cette demande. |
total_attachments | integer | Nombre total de pièces jointes de la demande. |
recipients | object | Objet contenant les informations d'origine et traitées des destinataires. |
created_at | object | Horodatage de la création de la demande. |
Champs de recipients
| Champ | Type | Description |
|---|---|---|
to | array | Destinataires to d'origine. |
cc | array | Destinataires cc d'origine. |
bcc | array | Destinataires bcc d'origine. |
Exemple de réponse
{
"status": "success",
"data": {
"email_request": {
"uuid": "2b687f6a-7e85-4c14-8b17-xxxxxxx",
"status": "QUEUED",
"total_recipients": 1,
"domain": "votredomaine.com",
"from_email": "[email protected]",
"subject": "Bonjour de Mailiqo",
"email_messages": [
"c82929b4-8c6e-45f0-b048-xxxxxxxxx"
],
"total_attachments": 0,
"recipients": {
"to": [
{
"email": "[email protected]",
"name": ""
}
],
"cc": [],
"bcc": []
},
"created_at": {
"date": "2026-03-20 10:29:05.000000",
"timezone_type": 3,
"timezone": "UTC"
}
}
}
}Réponses HTTP
| Statut | Signification |
|---|---|
200 | Demande d'envoi trouvée et renvoyée. |
404 | Demande d'envoi introuvable. |
500 | Erreur interne du serveur. |
Format de la réponse d'erreur
{
"status": "error",
"error": {
"code": "9999",
"message": "Error message describing the issue."
}
}Remarques
- Cet endpoint renvoie l'objet au niveau de la demande, pas l'enregistrement d'un email livré individuellement. La différence est que l'objet
email_requestcontient les informations de la demande d'origine, tandis que l'objetemail_messagereprésente le message traité envoyé à un seul destinataire. Chaqueemail_requestpeut générer plusieurs enregistrementsemail_messages'il y a plusieurs destinataires. - Utilisez cet endpoint quand vous devez inspecter les destinataires traités ou les métadonnées de la demande.
- Pour inspecter un message précis, utilisez
GET /mailing/email-message/{uuid}.
Endpoints associés
POST /v1/mailing/sendGET /v1/mailing/email-message/{uuid}
