> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Telefonverifizierung API: SMS-OTP & Risikosignale

> Didit: Zweistufige SMS-OTP-Verifizierung mit Carrier- und Wegwerfnummern-Erkennung. Carrier-Preis plus $0.02 Gebühr, ohne Verträge.

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

> [card] [Telefoncode senden](https://docs.didit.me/de/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/` — Senden Sie einen Einmalcode per SMS.

> [card] [Telefoncode prüfen](https://docs.didit.me/de/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/` — Prüfen Sie den Code und rufen Sie die Risikodaten der Telefonnummer ab.

> [card] [Telefonrisiko bewerten](https://docs.didit.me/de/standalone-apis/phone-risk.md)
>
> `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:

| Kanal | Beschreibung |
| - | - |
| SMS | Standard-Textnachricht |
| WhatsApp | WhatsApp-Nachricht |
| Telegram | Telegram-Nachricht |
| RCS | Rich Communication Services |
| Viber | Viber-Nachricht |

## Risikosignale

| Signal | Beschreibung |
| - | - |
| `is_disposable` | Temporäre oder Wegwerf-Telefonnummer |
| `is_virtual` | VoIP- oder virtuelle Nummer |
| `carrier.type` | `mobile`, `landline` oder `voip` |

Den vollständigen Aufbau der Antwort finden Sie im [Bericht zur Telefonverifizierung](https://docs.didit.me/de/core-technology/phone-verification/overview.md).

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.