Bulk toll-free verification guide

Follow

Luke Thompson

Updated


On January 31, 2024, the toll-free industry began blocking all traffic from pending toll-free numbers. This means any number that's not verified, whether restricted or pending, will have its traffic blocked.


This article serves as a guide to ensure your bulk toll-free verification form can be processed by our Toll-Free Messaging Aggregator. Please review the requirements below and note that each message sender can only use one number. Once you download the form and properly complete it, please email it to tfverification@bandwidth.com. To learn more about toll-free verification, check out the Bandwidth toll-free verification handbook.

Specific requirements

  • Do not modify the column headers in the bulk toll-free verification form.
  • Save the bulk verification form only as a .csv file.
  • The Phone_Numbers column may contain up to 1000 total phone numbers.
  • There is a 1000-character limit for the Message_Content and the Additional_Opt_In_Information columns. There's a 500-character limit for all other columns except for the Phone_Number column, which doesn't have a character limit.
  • If you’d like to include a comma within a field value, surround the value with double quotes.
  • Each row should be unique to an individual business.
  • Each column is required to have data within it (except for BusinessAddr2, State, Zip, AdditionalDocumentation, ISV/Reseller, InternalTicket, and Business Country).
  • The Use_Case_Category column must contain a valid use case.

Glossary of columns

Value Name Required   Max Characters
Business_Name (Text) Yes The end business / the business the consumer is engaging with. 500
Corporate_Website (Text) Yes The website of the end business. 500
Business_Addr1 (Text) Yes The address of the end business. 500
Business_Addr2 (Text) No The address of the end business. 500
City (Text) Yes The address of the end business. 500
State (Text - State Abbr.) Yes The address of the end business. 500
Zip (Text) Yes The address of the end business. 500
Business_Contact_First_
Name (Text)
Yes

The contact information of the end business.

Note: This won't be used to contact the customer during the verification process.

500
Business_Contact_Last_
Name (Text)
Yes

The contact information of the end business.

Note: This won't be used to contact the customer during the verification process.

500
Business_Contact_Email
(Text - email address)
Yes

The contact information of the end business.

Note: This won't be used to contact the customer during the verification process.

500
Business_Contact_Phone
_Number (Text - single
phone number)
Yes

The contact information of the end business.

Note: This won't be used to contact the customer during the verification process.

500
Message_Volume (Select
One: 10; 100; 1000;
10000; 100000; 250000;
500000; 750000;
1000000; 5000000;
10000000+)
Yes

Estimated Monthly Volume for the
submission. Choose the closest value, and if the customer is ramping please use the value of where the customer will be in 6 months.

Must use one of the listed values or the
submission will fail.

N/A
Phone_Numbers (Text -
numbers separated by ;)
Yes

The toll-free numbers that are part of the
submission:

Submissions of up to 5 numbers will be approved without having to explain the reason for needing multiple numbers.

Submissions over 5 numbers will need to
provide an explanation

Note: Please provide an explanation in the additional supporting documentation field.

N/A
Use_Case_Category
(Text)
Yes

Choose the use case that you believe best
fits your traffic pattern. If you wish to add multiple use cases please separate them with a
comma.

Download the list to see available choices and copy/paste one of the category names exactly as it’s written.
500
Use_Case_Summary
(Text)
Yes Description of the use case/submission. The more detail the better. 500
Message_Content (Text) Yes Provide production use case examples. 1000
Opt_In_Workflow_Description (Text - online, text to join, point of sale, etc.) Yes In as much detail provide how a consumer/subscriber opts into the end-business message program. 500
Additional_Opt_In_Information (Image URLs, Description, N/A, etc.) Yes Provide images of the opt-in process and what a subscriber is agreeing to. 1000
Additional_Supporting_Documentation (Text) No Any additional details that you want to add
or that you believe will help with the
verification such as privacy policies, AUPs, additional onboarding controls you have, links, etc.
500
Internal_Ticket_Number
(Text, URL)
No Your system’s ticket number. Allows for
easier tracking.
500
ISV/Reseller (Text) No Highly recommended
Please list the ISV/reseller name (Bandwidth account name) as this will drive efficiencies for bulk submissions.
500
Business_Country (Text) Yes

Please list the business country. 

N/A
External_Customer_Id (End business Account Identifier) No

An identifier for the end customer; can be used for tracking/identification on your side.

500

Article is closed for comments.