Skip to main content

Phone metadata

The phone verification service returns useful information about each phone number.

NameTypeExampleDescription
successBooleantrueReturns true if the service ran successfully*
is_verifiedBooleantrueThe number is valid and verified
not_verified_reasonStringThe phone number format is incorrectA short description of why is_verified is false
not_verified_codeStringFORMAT_INVALIDError code if is_verified is false

*The success response only indicates if the verification process ran all checks without issues regardless of if the phone number is valid or not.

Collection phone metadata using the widget events

The widget can be configured to collect metadata from the Phone Verification API response and populate this into fields of your form (hidden or visible to the user). The widget returns two events that can be used for this purpose.

View this code example demonstrating the use of the widget events.