Skip to content

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 ​

http
GET /mailing/email-request/{uuid}

Pfadparameter ​

ParameterTypPflichtBeschreibung
uuidstringJaUUID der E-Mail-Anfrage.

Beispielanfrage ​

bash
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 ​

FeldTypBeschreibung
uuidstringUUID der E-Mail-Anfrage.
statusstringAktueller Status der Anfrage
total_recipientsintegerGesamtzahl der Empfänger der Anfrage.
domainstringAbsenderdomain.
from_emailstringUrsprüngliche Absenderadresse.
subjectstringUrsprünglicher Betreff der E-Mail.
email_messagesarrayListe der UUIDs der aus dieser Anfrage erzeugten Nachrichten.
total_attachmentsintegerGesamtzahl der Anhänge der Anfrage.
recipientsobjectObjekt mit den ursprünglichen und verarbeiteten Empfängerinformationen.
created_atobjectZeitstempel der Erstellung der Anfrage.

Felder von recipients ​

FeldTypBeschreibung
toarrayUrsprüngliche to-Empfänger.
ccarrayUrsprüngliche cc-Empfänger.
bccarrayUrsprüngliche bcc-Empfänger.

Beispielantwort ​

json
{
  "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 ​

StatusBedeutung
200E-Mail-Anfrage gefunden und zurückgegeben.
404E-Mail-Anfrage nicht gefunden.
500Interner Serverfehler.

Format der Fehlerantwort ​

json
{
  "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_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.
  • 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/send
  • GET /v1/mailing/email-message/{uuid}

Built with VitePress