Skip to main content

Bulk toll-free verification guide

Updated over 2 weeks ago

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 [email protected]. 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

DBA (Text)

No

An optional field if the customer utilizes a DBA (Doing Business As).

This should be filled if the company name used to contact customers differs from the legal entity name.

500

Privacy_Policy_URL (Text)

No

Provide the optional URL for a privacy policy

500

Terms_And_Conditions_URL (text)

No

Provide the optional URL for a Terms and Conditions Link

500

Did this answer your question?