Ausgehende Faxaufträge auflisten

Verwenden Sie ein freigeschaltetes MultiTEL-Konto für die API über HTTPS mit den dafür konfigurierten Zugangsdaten und IP-Beschränkungen. Dieser Endpunkt listet die Datensätze zu ausgehenden Faxen auf, die dem authentifizierten Konto gehören. Das Auflisten überträgt kein Fax und versendet auch keines erneut.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

Abfrageparameter für den Postausgang
Parameter	Erforderlich	Bedeutung
`page`	Nein	Seitennummer, beginnend bei 1. Standardwert: 1.
`limit`	Nein	Datensätze pro Seite. Standardwert: 25; Höchstwert: 100. Verwenden Sie eine positive ganze Zahl.
`search`	Nein	Durchsucht Absendernummer, Zielnummer und die UUID des Auftrags. Führende und abschließende Leerzeichen werden entfernt. Status und Ergebnistext werden nicht durchsucht.

Diese Verarbeitungsroutine unterstützt weder date_from- noch date_to-Filter. Der Postausgang im Portal bietet zusätzliche Filter, die nicht in diese API-Anfrage übernommen werden sollten. Die Ergebnisse sind nach Erstellungszeit sortiert, die neuesten zuerst, ohne zusätzliche Sortierung nach ID und ohne Cursor für einen festen Datenstand.

Auftragsdatensätze lesen

Prüfen Sie sowohl das HTTP-Ergebnis als auch status.code in JSON. Eine erfolgreiche Antwort enthält response.faxes und response.pagination; das Beispiel verwendet fiktive Daten. Bei einem leeren Postfach wird ein leeres faxes-Array mit total 0 und total_pages 0 zurückgegeben.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id ist die numerische Datensatzkennung. uuid ist die sichtbare Auftragskennung; verwenden Sie die von send_fax für neue Übermittlungen zurückgegebene Auftragskennung und bewahren Sie sie für die regelmäßige Statusabfrage auf. Die Liste kann ältere Datensätze enthalten. Gehen Sie daher nicht davon aus, dass jede Zeile über denselben Endpunkt zur Übermittlung erstellt wurde.

status und result_text enthalten den aufgezeichneten Verarbeitungsstatus und die zugehörige Meldung. Diese Auflistung vereinheitlicht sie nicht zu einer vollständigen Aufzählung aller Zustellzustände. In der Warteschlange bedeutet in der Warteschlange, nicht zugestellt. Lassen Sie sich bei wichtigen Dokumenten den Empfang vom Empfänger bestätigen, bevor Sie das Fax als zugestellt betrachten oder eine weitere Kopie übermitteln.

pages_requested und pages_sent sind numerische Anzahlen. cost behält den gespeicherten Wert bei und verwendet als Ersatzwert die Zeichenfolge 0.00; gehen Sie nicht davon aus, dass der Wert denselben JSON-Typ wie die Kosten im Posteingang hat. Ein Datensatz in der Warteschlange kann bereits einen Schätzwert enthalten. Weder dieser Wert noch ein Listeneintrag legt die endgültige Abrechnung fest.

created_at, sent_at und updated_at sind gespeicherte Werte im Serverformat ohne Zeitzonenversatz; sent_at kann null sein. Das vom separaten Statusendpunkt zurückgegebene Feld für den Webhook-Status ist in der Liste nicht enthalten.

Ergebnisse über mehrere Seiten sicher abgleichen

Orientieren Sie sich an pagination.page, limit, total und total_pages. Seiten nach der letzten Seite können leer sein. Durch neue Aufträge können Einträge während des Durchblätterns auf andere Seiten verschoben werden. Behalten Sie beim Zusammenführen von Seiten die Auftragskennungen bei; dieser Endpunkt garantiert keinen unveränderlichen Datenstand.

Datenschutz und erneute Versuche

Die Datensätze im Postausgang enthalten vertrauliche Telefonmetadaten. Beschränken Sie den Lesezugriff und vermeiden Sie es, vollständige Antworten zu protokollieren. Ein fehlender Listeneintrag beweist nicht, dass eine Sendeanfrage fehlgeschlagen ist: Prüfen Sie vor einer erneuten Übermittlung die aufbewahrte Auftragskennung und den Postausgang im Portal. Ein erneuter Versand kann ein weiteres, möglicherweise kostenpflichtiges Fax erzeugen. Die endgültigen Zusicherungen zur Hintergrundverarbeitung, Abrechnung, zu Rückmeldungen und zur Aufbewahrung werden noch geprüft.