Contactivity Verify: phone verification API
Check that a user owns a phone number. We call it and speak a one-time code, and your app checks the code with one API call. The code is never returned by the API.
How it works
- 1
Create a profile
Once per app or flow: language, brand name, spoken phrases, code length, expiry, repeats and attempts.
- 2
Start a verification
Send the number. We call it and speak the code slowly, twice by default. The user can press 1 to hear it again.
- 3
Check the code
Your server sends the digits the user typed. approved means the user owns the number.
Features
- Code never returned
- We generate the code. It is not in any response, webhook, event or log, so it cannot leak from your servers.
- Profiles
- Code length 4 to 10 digits, expiry, times the code is repeated, check attempts and the brand name spoken first.
- Languages
- English (US), Spanish, French, German and Italian, in a built-in voice.
- Phrase presets
- Pick the intro, the line before the code and the closing line from fixed presets. No free text, so calls cannot be misused.
- Voicemail
- Machine detection is on by default. If voicemail answers, the code plays after the beep.
- Caller ID
- Calls come from our managed Verify numbers, signed with full attestation.
- Countries
- US and Canada by default. Other countries once international calling is approved for your project.
- Built-in protection
- Rate limits per number, per area code and per project. A profile can pause itself when its approval rate collapses.
- Webhooks
- verification.call.answered, verification.call.failed, verification.approved and verification.expired. No event carries the code.
- SDKs and sandbox
- Node and Python SDKs. Test numbers simulate answered, voicemail, busy and no-answer calls without placing one.
Start and check
Questions
Can I see or choose the code?
No. We generate it, and it is never returned by the API or sent in a webhook. Your app only sends the digits the user typed.
What if voicemail answers?
Machine detection is on by default, and the code plays after the beep. Each detection run is billed.
What number does the call come from?
Our managed Verify numbers, signed with full attestation. You do not choose the caller ID.
Which languages are spoken?
English (US), Spanish, French, German and Italian. Each profile picks one, and its intro, lead-in and closing line from fixed presets.
Can the code be sent by text message?
No. Contactivity Verify is voice only.
Can I test without placing calls?
Yes. In a sandbox project, test numbers simulate each call result with a known code, and cost nothing.
Related products
- Programmable voiceProgrammable voice lets your own code answer, place and control calls. Pick the model that fits: markup over HTTP, or events and REST actions.
- Phone numbersBuy US and Canada phone numbers for voice, local or toll-free, and route each one to a trunk, an app or a flow.
- SIP trunkingSIP trunking connects your PBX, contact center or SIP devices to the phone network, so they can call any US or Canada number and receive calls on your numbers.
Start in the sandbox
Try trunks, voice apps and flows with calls to your own verified numbers, before you add a card.

