Skip to main content

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.

The Phone Verification API provides a two-step flow: send a one-time code to a phone number, then verify the code. The system detects carrier type, virtual numbers, and disposable phones.

Endpoints

Send Phone Code

POST /v3/phone/send/ — Send a one-time verification code via SMS.

Check Phone Code

POST /v3/phone/check/ — Verify the code and retrieve phone risk data.

How it works

  1. Call Send Phone Code with the phone number in E.164 format (e.g., +14155552671)
  2. The user receives a code via SMS (valid for 5 minutes)
  3. Call Check Phone Code with the phone number and code
  4. Receive verification result plus risk signals (carrier type, virtual number detection)

Delivery channels

Didit supports multiple channels depending on country availability:
ChannelDescription
SMSStandard text message
WhatsAppWhatsApp messaging
TelegramTelegram messaging
RCSRich Communication Services
ViberViber messaging

Risk signals

SignalDescription
is_disposableTemporary/throwaway phone number
is_virtualVoIP or virtual number
carrier.typemobile, landline, or voip
For full response structure, see Phone Verification Report.