APIReference

Verify API

Start a cascading verification across SMS, WhatsApp and voice, and check its status.

POST/v1/verify/start
This reference documents the intended request/response shape. Exact field names are confirmed with our platform partner before this endpoint goes live.

01Parameters

NameTypeRequiredDescription
tostringRequiredRecipient number in E.164 format.
channelsstring[]OptionalCascade order, e.g. ["sms","whatsapp","voice"]. Defaults to your account setting.
code_lengthnumberOptional4–8 digits. Defaults to 6.
ttl_secondsnumberOptionalCode validity window. Defaults to 300.

02Request

curl https://api.msgbridge.in/v1/verify/start \  -H "Authorization: Bearer $API_KEY" \  -d to="+91XXXXXXXXXX" \  -d channels="sms,whatsapp,voice"

03Response

{  "verification_id": "vrf_88Ht",  "status": "pending",  "current_channel": "sms"}

Need a hand integrating this?

Our integration team reviews your first call for free.