メニュー

Expand
ページを評価:

Verification Attempts Summary

Verification Attempts Summary API is in Pilot!

This Verify feature is currently in the Pilot maturity stage, which means that:

1. We're actively looking for early-adopter customers to try it out and give feedback. That could be you!

2. You'll need to contact sales to request access to the API.

Lastly, please note that Verification Attempts Summary API currently only supports the SMS channel and will support CALL in a future release.

The Verification Attempts Summary API allows you to summarize verification attempts generated by your Verify V2 services.

A verification attempt is a communication attempt with the end user that contains a verification code and uses one of the channels supported by Twilio Verify. A single verification may generate one or more verification attempts.

This API contains one endpoint:

  1. Get a Verification Attempts Summary: Returns a summary of verification attempts including total conversions and conversion rate percentage

You can list, filter, and fetch verification attempts using the Verification Attempts API.

Verification Attempts Summary API currently supports only the SMS channel.

利用制限

Verification Attempts Summary API provides a built-in rate limit of 30 requests per minute. If you reach this limit, you will start receiving HTTP 429 "Too Many Requests" responses.

Timeouts

Verification Attempts Summary API has a timeout value of 15 seconds. However, its 99th percentile is within 1 second.

Verification Attempts Summary Response Properties

These properties are returned in the JSON response output.

Resource Properties in REST API format
total_attempts
integer Not PII

Total of attempts made according to the provided filters

total_converted
integer Not PII

Total of attempts made that were confirmed by the end user, according to the provided filters.

total_unconverted
integer Not PII

Total of attempts made that were not confirmed by the end user, according to the provided filters.

conversion_rate_percentage
decimal Not PII

Percentage of the confirmed messages over the total, defined by (total_converted/total_attempts)*100.

url
url Not PII

Get a Verification Attempts Summary

GET
https://verify.twilio.com/v2/Attempts/Summary

Returns a summary of verification attempts that match the selected query parameters.

パラメーター
Parameters in REST API format
service_sid
オプション
GET sid<VA> Not PII

Filter used to consider only Verification Attempts of the given verify service on the summary aggregation.

date_created_after
オプション
GET date_time<iso8601> Not PII

Datetime filter used to consider only Verification Attempts created after this datetime on the summary aggregation. Given as GMT in RFC 2822 format.

date_created_before
オプション
GET date_time<iso8601> Not PII

Datetime filter used to consider only Verification Attempts created before this datetime on the summary aggregation. Given as GMT in RFC 2822 format.

country
オプション
GET iso_country_code Not PII

Filter used to consider only Verification Attempts sent to the specified destination country on the summary aggregation.

channel
オプション
GET ienum:channels Not PII

Filter Verification Attempts considered on the summary aggregation by communication channel. Valid values are SMS and CALL

destination_prefix
オプション
GET 文字列 Not PII

Filter the Verification Attempts considered on the summary aggregation by Destination prefix. It is the prefix of a phone number in E.164 format.

例 1
        
        
        
        ページを評価:

        ヘルプが必要ですか?

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

              
              
              

              フィードバックくださりありがとうございます!

              Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

              Sending your feedback...
              🎉 Thank you for your feedback!
              Something went wrong. Please try again.

              Thanks for your feedback!

              Refer us and get $10 in 3 simple steps!

              ステップ1

              Get link

              Get a free personal referral link here

              ステップ2:

              Give $10

              Your user signs up and upgrade using link

              ステップ3

              Get $10

              1,250 free SMSes
              OR 1,000 free voice mins
              OR 12,000 chats
              OR more