Flash-Call Reachability Check (voice/flash-verify)

Flash-Call Reachability Check (voice/flash-verify)

Places a flash call (rings ~4 seconds, never answered) to confirm a phone number is a real, live, reachable line — billed a flat per-attempt fee rather than a per-minute rate. Requires a Voice Gateway device assigned to your account by 6X support first (contact support to have one set up).

Important — this proves reachability only, not ownership. Because the call is placed from a real physical SIM, its caller ID is fixed and cannot encode a per-attempt code the way SMS/email can. It confirms "this number is a real, live line," not "the person who submitted this number is holding the phone." If you need to confirm the customer actually owns the number, use Phone Verification (a real enterable SMS code) instead.

POST /api/v1/voice/flash-verify

Example request

curl -X POST https://app.6xcom.com/api/v1/voice/flash-verify \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"to":"+2348011234567"}'

Response

{
  "success": true,
  "callId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "status": "queued"
}

GET /api/v1/voice/flash-verify/{callId}

Poll for the result, or (recommended) subscribe to the flash_verification.completed webhook event instead of polling.

curl https://app.6xcom.com/api/v1/voice/flash-verify/d290f1ee-6c54-4b01-90e6-d701748f0851 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "success": true,
  "callId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "type": "flash",
  "status": "ended",
  "durationSeconds": 4,
  "cost": 0.05,
  "error": null
}

Error codes