Verify a phone number and retrieve intelligence using the Telesign API

Steps

1. Authenticate Telesign REST API requests using HTTP Basic Auth with your Customer ID and API key (YOUR_CUSTOMER_ID:YOUR_API_KEY).
2. For phone number verification (OTP), call the Telesign SMS Verify or Voice Verify endpoint by POST-ing the phone number and a message template; Telesign returns a reference ID.
3. Collect the OTP from the user and submit it to the Telesign verification check endpoint along with the reference ID to confirm the code is valid.
4. For phone intelligence (fraud risk assessment without OTP), call the Telesign PhoneID endpoint with the phone number to receive risk score, phone type (mobile, landline, VOIP), and carrier information.
5. Parse the PhoneID response's risk object for a score and recommendation field ('allow', 'flag', 'block') to feed into your onboarding risk decision.
6. Store the reference ID and risk signals for audit; use the phone type data to decide whether to permit VOIP numbers in your registration flow.