--- title: "List tollfree verifications" method: GET path: "/v1/Tollfree/Verifications" tags: ["MessagingV1TollfreeVerification"] --- # List tollfree verifications `GET /v1/Tollfree/Verifications` List tollfree verifications ## Query parameters - `TollfreePhoneNumberSid` string - `Status` 'PENDING_REVIEW' | 'IN_REVIEW' | 'TWILIO_APPROVED' | 'TWILIO_REJECTED' — The compliance status of the Tollfree Verification record. - `ExternalReferenceId` string - `IncludeSubAccounts` boolean - `PageSize` integer - `Page` integer - `PageToken` string - `TrustProductSid` string[] ## Response `200` OK - object - `verifications` MessagingV1TollfreeVerification[] - `sid` string, nullable — The unique string to identify Tollfree Verification. - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Tollfree Verification resource. - `customer_profile_sid` string, nullable — Customer's Profile Bundle BundleSid. - `trust_product_sid` string, nullable — Tollfree TrustProduct Bundle BundleSid. - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `regulated_item_sid` string, nullable — The SID of the Regulated Item. - `business_name` string, nullable — The name of the business or organization using the Tollfree number. - `business_street_address` string, nullable — The address of the business or organization using the Tollfree number. - `business_street_address2` string, nullable — The address of the business or organization using the Tollfree number. - `business_city` string, nullable — The city of the business or organization using the Tollfree number. - `business_state_province_region` string, nullable — The state/province/region of the business or organization using the Tollfree number. - `business_postal_code` string, nullable — The postal code of the business or organization using the Tollfree number. - `business_country` string, nullable — The country of the business or organization using the Tollfree number. - `business_website` string, nullable — The website of the business or organization using the Tollfree number. - `business_contact_first_name` string, nullable — The first name of the contact for the business or organization using the Tollfree number. - `business_contact_last_name` string, nullable — The last name of the contact for the business or organization using the Tollfree number. - `business_contact_email` string, nullable — The email address of the contact for the business or organization using the Tollfree number. - `business_contact_phone` string, phone-number, nullable — The E.164 formatted phone number of the contact for the business or organization using the Tollfree number. - `notification_email` string, nullable — The email address to receive the notification about the verification result. . - `use_case_categories` string[], nullable — The category of the use case for the Tollfree Number. List as many as are applicable. - `use_case_summary` string, nullable — Use this to further explain how messaging is used by the business or organization. - `production_message_sample` string, nullable — An example of message content, i.e. a sample message. - `opt_in_image_urls` string[], nullable — Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL. - `opt_in_type` 'VERBAL' | 'WEB_FORM' | 'PAPER_FORM' | 'VIA_TEXT' | 'MOBILE_QR_CODE' | 'IMPORT' | 'IMPORT_PLEASE_REPLACE' — Describe how a user opts-in to text messages. - `message_volume` string, nullable — Estimate monthly volume of messages from the Tollfree Number. - `additional_information` string, nullable — Additional information to be provided for verification. - `tollfree_phone_number_sid` string, nullable — The SID of the Phone Number associated with the Tollfree Verification. - `tollfree_phone_number` string, phone-number, nullable — The E.164 formatted toll-free phone number associated with the verification. - `status` 'PENDING_REVIEW' | 'IN_REVIEW' | 'TWILIO_APPROVED' | 'TWILIO_REJECTED' — The compliance status of the Tollfree Verification record. - `url` string, uri, nullable — The absolute URL of the Tollfree Verification resource. - `rejection_reason` string, nullable — The rejection reason given when a Tollfree Verification has been rejected. - `error_code` integer, nullable — The error code given when a Tollfree Verification has been rejected. - `edit_expiration` string, date-time, nullable — The date and time when the ability to edit a rejected verification expires. - `edit_allowed` boolean, nullable — If a rejected verification is allowed to be edited/resubmitted. Some rejection reasons allow editing and some do not. - `business_registration_number` string, nullable — A legally recognized business registration number - `business_registration_authority` 'EIN' | 'CBN' | 'CRN' | 'PROVINCIAL_NUMBER' | 'VAT' | 'ACN' | 'ABN' | 'BRN' | 'SIREN' | 'SIRET' | 'NZBN' | 'USt-IdNr' | 'CIF' | 'NIF' | 'CNPJ' | 'UID' | 'NEQ' | 'OTHER', nullable — The organizational authority for business registrations. Required for all business types except SOLE_PROPRIETOR. - `business_registration_country` string, nullable — Country business is registered in - `business_type` 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'SOLE_PROPRIETOR' | 'NON_PROFIT' | 'GOVERNMENT', nullable — The type of business, valid values are PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, SOLE_PROPRIETOR, GOVERNMENT. Required field. - `business_registration_phone_number` string, nullable — The E.164 formatted number associated with the business. - `doing_business_as` string, nullable — Trade name, sub entity, or downstream business name of business being submitted for verification - `opt_in_confirmation_message` string, nullable — The confirmation message sent to users when they opt in to receive messages. - `help_message_sample` string, nullable — A sample help message provided to users. - `privacy_policy_url` string, uri, nullable — The URL to the privacy policy for the business or organization. - `terms_and_conditions_url` string, uri, nullable — The URL of the terms and conditions for the business or organization. - `age_gated_content` boolean, nullable — Indicates if the content is age gated. - `opt_in_keywords` string[], nullable — List of keywords that users can send to opt in or out of messages. - `rejection_reasons` unknown[], nullable — A list of rejection reasons and codes describing why a Tollfree Verification has been rejected. - unknown - `resource_links` unknown - `external_reference_id` string, nullable — An optional external reference ID supplied by customer and echoed back on status retrieval. - `vetting_id` string, nullable - `vetting_provider` 'CAMPAIGN_VERIFY', nullable — The third-party political vetting provider. - `vetting_id_expiration` string, date-time, nullable - `meta` object - `first_page_url` string, uri - `key` string - `next_page_url` string, uri, nullable - `page` integer - `page_size` integer - `previous_page_url` string, uri, nullable - `url` string, uri --- [API](https://skmtc.net/twilio/apis/twilio-messaging.md) · [All operations](https://skmtc.net/twilio/apis/twilio-messaging/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-messaging/revisions/ef8fb6b6bfee/schema)