Verify

Calls to and, when answered, reads the code one digit at a time: "Your {brand} verification code is 4, 8, 2, 9, 1, 3. Again, 4, 8, 2, 9, 1, 3." Repeated repeat times (default 2, max 3), then the call hangs up. Pass your own code (4-10 digits) or let us generate one of length digits (default 6); a generated code is returned only when you set returnCode: true. You check the code yourself; use POST /verify/start instead to have us check it. Languages: en, es, fr, de, pt, hi. brand defaults to your company name and is cleaned to letters, digits and spaces (max 30). Returns as soon as the call is ringing; the outcome and cost arrive with the call.completed webhook and on GET /comms/voice-otp/{id}. Billed exactly like POST /comms/calls: the route rate per billing increment plus the platform fee. No text-to-speech surcharge. A test key simulates the call against test credit. Omit strategy and the code goes out over Smart Routing's best_quality route for the destination (plain calls and SMS default to balanced). Limits, shared by voice passcodes and the Verify API: 5 codes per number per hour, 30 seconds between codes to the same number, a per-account daily cap, and a cap on codes into one number range per hour. A limit answers 429 with details.retryAfterSeconds. Embargoed destinations, premium-rate / satellite / high-risk ranges and numbers on your Do-Not-Contact list are refused with 400.

Whether the call was answered, how long it ran and what it cost. Never returns the code.

Generates a code of length digits (default 6), sends it over channel, and returns a verificationId. We store only a keyed hash (HMAC) of the code; the code itself is never stored or logged. The code expires after expirySeconds (default 600). SMS languages: en, es, fr, de, pt, hi, ar. Voice languages: en, es, fr, de, pt, hi. from is the SMS sender ID (defaults to your brand) or, for voice, the caller ID. Billed as the SMS or call that carries the code: the route rate plus the platform fee, no verification fee. A test key sends nothing, charges test credit and returns testCode so you can finish the flow. Omit strategy and the code goes out over Smart Routing's best_quality route for the destination (plain calls and SMS default to balanced). Limits, shared by voice passcodes and the Verify API: 5 codes per number per hour, 30 seconds between codes to the same number, a per-account daily cap, and a cap on codes into one number range per hour. A limit answers 429 with details.retryAfterSeconds. Embargoed destinations, premium-rate / satellite / high-risk ranges and numbers on your Do-Not-Contact list are refused with 400.

approved exactly once: a code is single use, and a second check of an approved verification answers denied with reason already_used. Five attempts in total; the fifth wrong guess answers max_attempts and the verification is dead. After expiresAt every check answers expired, even with the right code. Spaces and dashes in the submitted code are ignored. The comparison is constant-time.

Status, attempts used and how the code was delivered. Never returns the code.