GET /mailing/email-request/{uuid}
Ruft den Basisstatus und die Details einer E-Mail-Anfrage ab.
Überblick
Nutze diesen Endpunkt, um die ursprüngliche Sendeanfrage nach ihrer Erstellung zu untersuchen.
Er liefert das Objekt email_request, das die Basisanfrage und ihre verarbeiteten Empfängerinformationen darstellt.
Endpunkt
GET /mailing/email-request/{uuid}Pfadparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
uuid | string | Ja | UUID der E-Mail-Anfrage. |
Beispielanfrage
curl -X GET https://api.mailiqo.com/v1/mailing/email-request/2b687f6a-7e85-4c14-8b17-xxxxxxx \
-H "X-API-KEY: YOUR_API_KEY"Aufbau der Antwort
Die Antwort ist in {status, data} gekapselt, und data enthält das Objekt email_request.
⚠️ Dieser Endpunkt liefert das Objekt auf Anfrageebene, nicht den Datensatz einer einzelnen zugestellten E-Mail. Der Unterschied: das Objekt email_request enthält die Informationen der ursprünglichen Anfrage, während das Objekt email_message die verarbeitete E-Mail darstellt, die an einen einzelnen Empfänger gesendet wurde. Jede email_request kann bei mehreren Empfängern mehrere email_message-Datensätze erzeugen.
Felder von email_request
| Feld | Typ | Beschreibung |
|---|---|---|
uuid | string | UUID der E-Mail-Anfrage. |
status | string | Aktueller Status der Anfrage |
total_recipients | integer | Gesamtzahl der Empfänger der Anfrage. |
domain | string | Absenderdomain. |
from_email | string | Ursprüngliche Absenderadresse. |
subject | string | Ursprünglicher Betreff der E-Mail. |
email_messages | array | Liste der UUIDs der aus dieser Anfrage erzeugten Nachrichten. |
total_attachments | integer | Gesamtzahl der Anhänge der Anfrage. |
recipients | object | Objekt mit den ursprünglichen und verarbeiteten Empfängerinformationen. |
created_at | object | Zeitstempel der Erstellung der Anfrage. |
Felder von recipients
| Feld | Typ | Beschreibung |
|---|---|---|
to | array | Ursprüngliche to-Empfänger. |
cc | array | Ursprüngliche cc-Empfänger. |
bcc | array | Ursprüngliche bcc-Empfänger. |
Beispielantwort
{
"status": "success",
"data": {
"email_request": {
"uuid": "2b687f6a-7e85-4c14-8b17-xxxxxxx",
"status": "QUEUED",
"total_recipients": 1,
"domain": "deinedomain.com",
"from_email": "[email protected]",
"subject": "Hallo von 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"
}
}
}
}HTTP-Antworten
| Status | Bedeutung |
|---|---|
200 | E-Mail-Anfrage gefunden und zurückgegeben. |
404 | E-Mail-Anfrage nicht gefunden. |
500 | Interner Serverfehler. |
Format der Fehlerantwort
{
"status": "error",
"error": {
"code": "9999",
"message": "Error message describing the issue."
}
}Hinweise
- Dieser Endpunkt liefert das Objekt auf Anfrageebene, nicht den Datensatz einer einzelnen zugestellten E-Mail. Der Unterschied: das Objekt
email_requestenthält die Informationen der ursprünglichen Anfrage, während das Objektemail_messagedie verarbeitete E-Mail darstellt, die an einen einzelnen Empfänger gesendet wurde. Jedeemail_requestkann bei mehreren Empfängern mehrereemail_message-Datensätze erzeugen. - Nutze diesen Endpunkt, wenn du die verarbeiteten Empfänger oder die Metadaten der Anfrage untersuchen willst.
- Um eine bestimmte E-Mail-Nachricht zu untersuchen, nutze
GET /mailing/email-message/{uuid}.
Verwandte Endpunkte
POST /v1/mailing/sendGET /v1/mailing/email-message/{uuid}
