Menu

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Verification Check

The Verification Check Resource represents a verification validation. This will check whether the user-provided token is correct.

Prerequisites:

  1. Create a Verification Service
  2. Start a Verification

VerificationCheck Response Properties

These fields are returned in the output JSON response. The type SID<VE> is a unique ID starting with the letters VE.

Names in PHP format
sid
sid<VE> Not PII

The unique string that we created to identify the VerificationCheck resource.

serviceSid
sid<VA> Not PII

The SID of the Service the resource is associated with.

accountSid
sid<AC> Not PII

The SID of the Account that created the VerificationCheck resource.

to

The phone number or email being verified. Phone numbers must be in E.164 format.

channel
enum:channel Not PII

The verification method to use. Can be: email, sms or call.

status
string Not PII

The status of the verification. Can be: pending, approved, denied, or expired.

valid
boolean Not PII

Whether the verification was successful.

amount

The amount of the associated PSD2 compliant transaction. Requires the PSD2 Service flag enabled.

payee

The payee of the associated PSD2 compliant transaction. Requires the PSD2 Service flag enabled.

dateCreated
date_time<iso8601> Not PII

The ISO 8601 date and time in GMT when the Verification Check resource was created.

dateUpdated
date_time<iso8601> Not PII

The ISO 8601 date and time in GMT when the Verification Check resource was last updated.

Check a Verification

post
https://verify.twilio.com/v2/Services/{ServiceSid}/VerificationCheck

These are the available input parameters for checking a verification. The type SID<VE> is a unique ID starting with the letters VE.

Parameters
Names in None format
service_sid
Required
post sid<VA> Not PII

The SID of the verification Service to create the resource under.

code
Required
post string Not PII

The 4-10 character string being verified.

to
Optional
post string PII MTL: 30 DAYS

The phone number to verify. Either this parameter or the verification_sid must be specified. Phone numbers must be in E.164 format.

verification_sid
Optional
post sid<VE> Not PII

A SID that uniquely identifies the Verification Check. Either this parameter or the to phone number must be specified.

amount
Optional
post string PII MTL: 1 DAYS

The amount of the associated PSD2 compliant transaction. Requires the PSD2 Service flag enabled.

payee
Optional
post string PII MTL: 1 DAYS

The payee of the associated PSD2 compliant transaction. Requires the PSD2 Service flag enabled.

Example 1
        
        
        
        
        Example 2
              
              
              
              
              Alternative to checking with a Phone Number

              Check a Verification with a SID

              Alternative to checking with a Phone Number
              Rate this page:

              Need some help?

              We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.