Sign in

v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-04-145745483.2 KB
VerifyV2Verification

Create a new Verification using a Service

Create a new Verification using a Service

post/v2/Services/{ServiceSid}/Verifications

Path parameters

ServiceSidstring required

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

Response

Created

sidstring nullable

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

service_sidstring nullable

The SID of the Service the resource is associated with.

account_sidstring nullable

The SID of the Account that created the Verification resource.

tostring nullable

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

channel'sms' | 'call' | 'email' | 'whatsapp' | 'sna'

The verification method used. One of: email, sms, whatsapp, call, sna, or rcs.

statusstring nullable

The status of the verification. Can be: pending, approved, canceled, max_attempts_reached, deleted, failed or expired.

validboolean nullable

Use "status" instead. Legacy property indicating whether the verification was successful.

{"stackTrail":"components:schemas:verify.v2.service.verification:properties:lookup","oasType":"schema","type":"unknown","description":"Information about the phone number being verified.","nullable":true}
amountstring nullable

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

payeestring nullable

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

date_createdstring date-time nullable

The date and time in GMT when the resource was created specified in RFC 2822 format.

date_updatedstring date-time nullable

The date and time in GMT when the resource was last updated specified in RFC 2822 format.

{"stackTrail":"components:schemas:verify.v2.service.verification:properties:sna","oasType":"schema","type":"unknown","description":"The set of fields used for a silent network auth (`sna`) verification. Contains a single field with the URL to be invoked to verify the phone number.","nullable":true}
urlstring uri nullable

The absolute URL of the Verification resource.