Telephony

Phone Verify

Make an automated call to any valid phone number and playback a unique security code

post/phone-verify

Request

  • Base URL
    https://neutrinoapi.net
  • Auth
    API key in header user-id and API key in header api-key

Request body application/x-www-form-urlencoded

numberstring required

The phone number to send the verification code to

code-lengthinteger

The number of digits to use in the security code (between 4 and 12)

security-codeinteger

Pass in your own security code. This is useful if you have implemented TOTP or similar 2FA methods. If not set then we will generate a secure random code

playback-delayinteger

The delay in milliseconds between the playback of each security code

country-codestring

ISO 2-letter country code, assume numbers are based in this country. <br> If not set numbers are assumed to be in international format (with or without the leading + sign)

language-codestring

The language to playback the verification code in, available languages are: <ul> <li>de - German</li> <li>en - English</li> <li>es - Spanish</li> <li>fr - French</li> <li>it - Italian</li> <li>pt - Portuguese</li> <li>ru - Russian</li> </ul>

limitinteger

Limit the total number of calls allowed to the supplied phone number, if the limit is reached within the TTL then error code 14 will be returned

limit-ttlinteger

Set the TTL in number of days that the 'limit' option will remember a phone number (the default is 1 day and the maximum is 365 days)

Response

OK

number-validboolean required

True if this a valid phone number

callingboolean required

True if the call is being made now

security-codestring required

The security code generated, you can save this code to perform your own verification or you can use the <a href="https://www.neutrinoapi.com/api/verify-security-code/">Verify Security Code API</a>

Changes

No recorded changes to this operation across all 4 revisions of this API.