List tollfree verification
A Messaging resource to create and retrieve Tollfree Verifications.
Query parameters
-
The SID of the Phone Number associated with the Tollfree Verification.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^PN[0-9a-fA-F]{32}$
. -
The compliance status of the Tollfree Verification record.
Values are
PENDING_REVIEW
,IN_REVIEW
,TWILIO_APPROVED
, orTWILIO_REJECTED
. -
Customer supplied reference id for the Tollfree Verification record.
-
Whether to include Tollfree Verifications from sub accounts in list response.
-
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1
, maximum value is1000
. -
The page index. This value is simply for client state.
Minimum value is
0
. -
The page token. This is provided by the API.
curl \
--request GET 'https://messaging.twilio.com/v1/Tollfree/Verifications' \
--user "username:password"
{
"meta": {
"key": "verifications",
"url": "https://messaging.twilio.com/v1/Tollfree/Verifications?Status=TWILIO_APPROVED&ExternalReferenceId=abc123xyz567&TollfreePhoneNumberSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&IncludeSubAccounts=false&PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://messaging.twilio.com/v1/Tollfree/Verifications?Status=TWILIO_APPROVED&ExternalReferenceId=abc123xyz567&TollfreePhoneNumberSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&IncludeSubAccounts=false&PageSize=50&Page=0",
"previous_page_url": null
},
"verifications": [
{
"sid": "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "TWILIO_APPROVED",
"error_code": null,
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"opt_in_type": "VERBAL",
"date_created": "2021-01-27T14:18:35Z",
"date_updated": "2021-01-27T14:18:36Z",
"edit_allowed": null,
"business_city": "Anytown",
"business_name": "Owl, Inc.",
"message_volume": "1,000",
"resource_links": {
"trust_product": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"customer_profile": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"channel_endpoint_assignment": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
"edit_expiration": null,
"business_country": "US",
"business_website": "http://www.company.com",
"rejection_reason": null,
"use_case_summary": "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop",
"opt_in_image_urls": [
"https://testbusiness.com/images/image1.jpg",
"https://testbusiness.com/images/image2.jpg"
],
"rejection_reasons": null,
"trust_product_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"notification_email": "support@company.com",
"regulated_item_sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"use_case_categories": [
"TWO_FACTOR_AUTHENTICATION",
"MARKETING"
],
"business_postal_code": "11111",
"customer_profile_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"external_reference_id": "abc123xyz567",
"additional_information": "see our privacy policy here www.johnscoffeeshop.com/privacypolicy",
"business_contact_email": "email@company.com",
"business_contact_phone": "+11231231234",
"business_street_address": "123 Main Street",
"business_street_address2": "Suite 101",
"production_message_sample": "lorem ipsum",
"tollfree_phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"business_contact_last_name": "lastname",
"business_contact_first_name": "firstname",
"business_state_province_region": "AA"
}
]
}