Uitgaande faxopdrachten opvragen

Uitgaande faxopdrachten opvragen

Gebruik een ingeschakeld MultiTEL API-account via HTTPS met de daarvoor ingestelde inloggegevens en IP-beperkingen. Dit eindpunt geeft een lijst van uitgaande faxrecords die bij het geauthenticeerde account horen. Het opvragen van de lijst verzendt geen fax en verstuurt ook geen fax opnieuw.

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

Deze verwerker ondersteunt geen filters voor date_from of date_to. Het overzicht van uitgaande faxen in het portaal heeft aanvullende filters die u niet in dit API-verzoek moet overnemen. Resultaten worden gesorteerd op aanmaaktijd, met de nieuwste eerst, zonder aanvullende sortering op identificatienummer of cursor voor een momentopname.

Opdrachtrecords bekijken

Controleer zowel het HTTP-resultaat als status.code in de JSON-gegevens. Een geslaagd antwoord bevat response.faxes en response.pagination; het voorbeeld gebruikt fictieve gegevens. Bij een lege mailbox wordt een lege faxes-array teruggegeven met total 0 en total_pages 0.

{
  "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 is het numerieke identificatienummer van het record. uuid is de zichtbare identificatiecode van de opdracht; gebruik voor nieuwe verzendingen de opdrachtcode die wordt teruggegeven door send_fax en bewaar deze voor het periodiek opvragen van de status. De lijst kan oudere records bevatten, dus ga er niet van uit dat elke rij via hetzelfde eindpunt voor verzendingen is aangemaakt.

status en result_text bevatten de vastgelegde verwerkingsstatus en melding. In dit overzicht worden deze niet omgezet naar een volledige opsomming van mogelijke afleverstatussen. In de wachtrij betekent in de wachtrij, niet afgeleverd. Laat bij cruciale documenten de ontvanger de ontvangst bevestigen voordat u de fax als afgeleverd beschouwt of een duplicaat verzendt.

pages_requested en pages_sent zijn numerieke aantallen. cost behoudt de opgeslagen waarde, met als terugvalwaarde de tekenreeks 0.00; ga er niet van uit dat deze hetzelfde JSON-type heeft als de kosten van een inkomende fax. Een record in de wachtrij kan al een kostenraming bevatten. Noch die waarde, noch een vermelding in de lijst bevestigt de definitieve facturering.

created_at, sent_at en updated_at zijn opgeslagen waarden in de servernotatie zonder tijdzone-offset; sent_at kan null zijn. De lijst bevat niet het veld voor de webhookstatus dat het afzonderlijke statuseindpunt teruggeeft.

Pagina's veilig vergelijken en samenvoegen

Houd rekening met pagination.page, limit, total en total_pages. Pagina's na de laatste pagina kunnen leeg zijn. Door nieuwe opdrachten kunnen vermeldingen tijdens het bladeren naar een andere pagina verschuiven. Bewaar de identificatiecodes van opdrachten wanneer u pagina's samenvoegt; dit eindpunt garandeert geen onveranderlijke momentopname.

Privacy en herhaalde pogingen

Records van uitgaande faxen bevatten vertrouwelijke telefonische metadata. Beperk wie ze kan lezen en vermijd het opslaan van volledige antwoorden in logbestanden. Het ontbreken van een vermelding in de lijst bewijst niet dat een verzendverzoek is mislukt: controleer de bewaarde opdrachtcode en het overzicht van uitgaande faxen in het portaal voordat u opnieuw een verzending aanvraagt. Een nieuwe verzending kan een extra fax opleveren waarvoor mogelijk kosten in rekening worden gebracht. De definitieve garanties voor de achtergrondverwerker, facturering, terugmeldingen en gegevensbewaring worden nog beoordeeld.