GET /v1/mailing/email-message/{uuid}
Ruft den Status und die Tracking-Daten einer einzelnen E-Mail-Nachricht ab.
Überblick
Nutze diesen Endpunkt, um eine einzelne E-Mail-Nachricht nach der Verarbeitung zu untersuchen.
Er liefert das Objekt auf E-Mail-Ebene, mit Empfänger, Zustellstatus, Zeitstempeln, Tracking-Zählern und Fehlerinformationen.
Endpunkt
http
GET /v1/mailing/email-message/{uuid}Pfadparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
uuid | string | Ja | UUID der E-Mail-Nachricht. |
Beispielanfrage
bash
curl -X GET https://api.mailiqo.com/v1/mailing/email-message/8c2db709-4df2-47c4-b03f-xxxxxxxx \
-H "X-API-KEY: YOUR_API_KEY"Beispielantwort
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
}
}Die unten beschriebenen Felder sind die innerhalb von data.
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
uuid | string | UUID der E-Mail-Nachricht. |
email_message_base_uuid | string | UUID der ursprünglichen E-Mail-Anfrage. |
recipient_email | string | E-Mail-Adresse des Empfängers. |
recipient_type | string | Empfängertyp: to, cc oder bcc. |
status | string | Aktueller Status der E-Mail-Nachricht. |
validation | object | Ergebnis der Validierung vor dem Versand. Immer vorhanden; gibt es noch kein Ergebnis, ist checked false. Siehe Das Ergebnis lesen. |
error_code | string oder null | Fehlercode, falls die Zustellung fehlgeschlagen ist. |
error_message | string oder null | Fehlermeldung, falls die Zustellung fehlgeschlagen ist. |
created_at | string (ISO 8601) | Zeitstempel der Erstellung der E-Mail-Nachricht. |
submitted_at | string (ISO 8601) oder null | Zeitstempel der Übergabe zur Verarbeitung. |
sent_at | string (ISO 8601) oder null | Zeitstempel des Versands an den Provider. |
delivered_at | string (ISO 8601) oder null | Zeitstempel der Zustellung beim Empfänger. |
bounced_at | string (ISO 8601) oder null | Zeitstempel des Bounces. |
complained_at | string (ISO 8601) oder null | Zeitstempel der Beschwerde des Empfängers. |
rejected_at | string (ISO 8601) oder null | Zeitstempel der Ablehnung der E-Mail. |
error_at | string (ISO 8601) oder null | Zeitstempel, zu dem ein Fehler erfasst wurde. |
failed_at | string (ISO 8601) oder null | Zeitstempel des endgültigen Fehlschlags. |
first_opened_at | string (ISO 8601) oder null | Zeitstempel der ersten Öffnung. |
last_opened_at | string (ISO 8601) oder null | Zeitstempel der letzten Öffnung. |
first_clicked_at | string (ISO 8601) oder null | Zeitstempel des ersten Klicks. |
last_clicked_at | string (ISO 8601) oder null | Zeitstempel des letzten Klicks. |
opens_count | integer | Gesamtzahl der Öffnungen der E-Mail. |
clicks_count | integer | Gesamtzahl der Klicks auf Links in der E-Mail. |
Das Objekt validation
Hier liest du das Ergebnis der Empfängervalidierung. Die erweiterte Validierung läuft während des Versands, nachdem POST /send dir schon geantwortet hat, deshalb ist dieser Block der einzige Weg, sie zu sehen.
| Feld | Typ | Beschreibung |
|---|---|---|
checked | boolean | Ein Validierungsergebnis liegt bereits vor. |
pending | boolean | Zur Prüfung vorgemerkt, aber der Versand hat noch nicht validiert. |
advanced | boolean | Die Prüfung hat ein Guthaben für erweiterte Validierung verwendet. |
classification | string oder null | valid, catch_all, risky, unknown oder invalid. |
reason | string oder null | Lesbarer Grund, wenn das Ergebnis nicht valid ist. |
reason_code | string oder null | Stabiler Code für den Grund. |
checked_at | string (ISO 8601) oder null | Datum der Prüfung, nicht des Versands: die Wiederverwendung eines früheren Ergebnisses erneuert es nicht. |
Wenn die Validierung einen Empfänger verwirft, wird status zu rejected, und der Grund erscheint auch in error_message.
Häufige Statuswerte
| Status | Bedeutung |
|---|---|
processing | Wartet auf Verarbeitung. |
submitted | Zur Verarbeitung übergeben. |
sent | An den Provider gesendet. |
delivery_delayed | Zustellung vorübergehend verzögert. |
delivered | Erfolgreich zugestellt. |
opened | Vom Empfänger geöffnet. |
clicked | Der Empfänger hat einen Link angeklickt. |
bounced | Vom Empfängerserver abgelehnt. |
complained | Vom Empfänger als Spam markiert. |
rejected | Vom Provider abgelehnt. |
quarantined | Zur manuellen Prüfung zurückgehalten. |
error | Versand wegen eines Fehlers fehlgeschlagen. |
failed | Endgültig fehlgeschlagen. |
retry_scheduled | Für einen erneuten Versuch eingeplant. |
HTTP-Antworten
| Status | Bedeutung |
|---|---|
200 | E-Mail-Nachricht gefunden und zurückgegeben. |
404 | E-Mail-Nachricht nicht gefunden. |
500 | Interner Serverfehler. |
Format der Fehlerantwort
json
{
"status": "error",
"error": {
"code": "9999",
"message": "Detailed error message describing the issue."
}
}Hinweise
- Dieser Endpunkt liefert eine einzelne E-Mail-Nachricht.
- Eine Sendeanfrage kann je nach Empfängern mehrere E-Mail-Datensätze erzeugen.
- Nutze
email_message_base_uuid, um die Nachricht der ursprünglichen Anfrage zuzuordnen.
Verwandte Endpunkte
POST /v1/mailing/sendGET /v1/mailing/email-request/{uuid}
