Skip to content

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 ​

ParameterTypPflichtBeschreibung
uuidstringJaUUID 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 ​

FeldTypBeschreibung
uuidstringUUID der E-Mail-Nachricht.
email_message_base_uuidstringUUID der ursprünglichen E-Mail-Anfrage.
recipient_emailstringE-Mail-Adresse des Empfängers.
recipient_typestringEmpfängertyp: to, cc oder bcc.
statusstringAktueller Status der E-Mail-Nachricht.
validationobjectErgebnis der Validierung vor dem Versand. Immer vorhanden; gibt es noch kein Ergebnis, ist checked false. Siehe Das Ergebnis lesen.
error_codestring oder nullFehlercode, falls die Zustellung fehlgeschlagen ist.
error_messagestring oder nullFehlermeldung, falls die Zustellung fehlgeschlagen ist.
created_atstring (ISO 8601)Zeitstempel der Erstellung der E-Mail-Nachricht.
submitted_atstring (ISO 8601) oder nullZeitstempel der Übergabe zur Verarbeitung.
sent_atstring (ISO 8601) oder nullZeitstempel des Versands an den Provider.
delivered_atstring (ISO 8601) oder nullZeitstempel der Zustellung beim Empfänger.
bounced_atstring (ISO 8601) oder nullZeitstempel des Bounces.
complained_atstring (ISO 8601) oder nullZeitstempel der Beschwerde des Empfängers.
rejected_atstring (ISO 8601) oder nullZeitstempel der Ablehnung der E-Mail.
error_atstring (ISO 8601) oder nullZeitstempel, zu dem ein Fehler erfasst wurde.
failed_atstring (ISO 8601) oder nullZeitstempel des endgültigen Fehlschlags.
first_opened_atstring (ISO 8601) oder nullZeitstempel der ersten Öffnung.
last_opened_atstring (ISO 8601) oder nullZeitstempel der letzten Öffnung.
first_clicked_atstring (ISO 8601) oder nullZeitstempel des ersten Klicks.
last_clicked_atstring (ISO 8601) oder nullZeitstempel des letzten Klicks.
opens_countintegerGesamtzahl der Öffnungen der E-Mail.
clicks_countintegerGesamtzahl 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.

FeldTypBeschreibung
checkedbooleanEin Validierungsergebnis liegt bereits vor.
pendingbooleanZur Prüfung vorgemerkt, aber der Versand hat noch nicht validiert.
advancedbooleanDie Prüfung hat ein Guthaben für erweiterte Validierung verwendet.
classificationstring oder nullvalid, catch_all, risky, unknown oder invalid.
reasonstring oder nullLesbarer Grund, wenn das Ergebnis nicht valid ist.
reason_codestring oder nullStabiler Code für den Grund.
checked_atstring (ISO 8601) oder nullDatum 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 ​

StatusBedeutung
processingWartet auf Verarbeitung.
submittedZur Verarbeitung übergeben.
sentAn den Provider gesendet.
delivery_delayedZustellung vorübergehend verzögert.
deliveredErfolgreich zugestellt.
openedVom Empfänger geöffnet.
clickedDer Empfänger hat einen Link angeklickt.
bouncedVom Empfängerserver abgelehnt.
complainedVom Empfänger als Spam markiert.
rejectedVom Provider abgelehnt.
quarantinedZur manuellen Prüfung zurückgehalten.
errorVersand wegen eines Fehlers fehlgeschlagen.
failedEndgültig fehlgeschlagen.
retry_scheduledFür einen erneuten Versuch eingeplant.

HTTP-Antworten ​

StatusBedeutung
200E-Mail-Nachricht gefunden und zurückgegeben.
404E-Mail-Nachricht nicht gefunden.
500Interner 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/send
  • GET /v1/mailing/email-request/{uuid}

Built with VitePress