Zum Hauptinhalt springen
Die Telefonverifizierungs-API bietet einen zweistufigen Ablauf: Sie senden einen Einmalcode an eine Telefonnummer und prüfen danach den Code. Das System erkennt den Typ des Netzbetreibers, virtuelle Nummern und Wegwerf-Telefonnummern.

​
Endpoints

Telefoncode senden

POST /v3/phone/send/ — Senden Sie einen Einmalcode per SMS.

Telefoncode prüfen

POST /v3/phone/check/ — Prüfen Sie den Code und rufen Sie die Risikodaten der Telefonnummer ab.

Telefonrisiko bewerten

POST /v3/phone/risk/ — Bewerten Sie Netzbetreiber, Leitungstyp, Rufnummernportierung und Betrugsrisiko, ohne ein OTP zu senden.

​
So funktioniert es

  1. Rufen Sie Telefoncode senden mit der Telefonnummer im E.164-Format auf (z. B. +14155552671)
  2. Der Benutzer erhält einen Code per SMS (gültig für 5 Minuten)
  3. Rufen Sie Telefoncode prüfen mit der Telefonnummer und dem Code auf
  4. Sie erhalten das Verifizierungsergebnis sowie Risikosignale (Typ des Netzbetreibers, Erkennung virtueller Nummern)

​
Zustellungskanäle

Didit unterstützt je nach Verfügbarkeit im jeweiligen Land mehrere Kanäle:

​
Risikosignale

Den vollständigen Aufbau der Antwort finden Sie im Bericht zur Telefonverifizierung.

​
Ausfälle des Anbieters

Wenn der vorgelagerte Telefonanbieter eine Sende- oder Prüfanfrage nicht beantwortet, geben beide Endpoints 502 mit code: "phone_provider_unavailable" statt eines allgemeinen Fehlers zurück. Ein Wiederholungsversuch ist unbedenklich, wird nicht abgerechnet und verbraucht keinen Versuch aus dem stündlichen Limit pro Nummer. Verzweigen Sie in Ihrer Logik anhand von code, statt den Wortlaut der Meldung in detail auszuwerten, da dieser kein stabiler Vertrag ist.
Zuletzt geändert am 7. November 2026