Answers and practical details
Frequently Asked Questions
Find out how to prepare a batch file, understand lookup results, and use the API.
Batch files and billing
It means checking a whole list of phone numbers at once, whether that’s a few hundred or a few million. Upload a CSV or Excel (.xlsx) file as it is and pick the phone column from a preview. There’s no need to trim it down to one column first.
Your CRM export can stay as it is. In most cases your browser pulls out just the phone column, so names, emails and other details are never uploaded. Results come back in the same row order, so you can paste them right next to your original rows. Our Excel and CSV guide walks you through it.
Is your list in another format, or stored in S3, Google Drive or another system? We can import it directly. Contact us.
To have us process your phone list, submit a batch. The wizard will guide you through uploading your file and making payment. Processing starts automatically after payment.
Upload a CSV or Excel (.xlsx) file and pick the phone column (and the worksheet, for Excel) from a preview. CSV files can be up to 1 GB and may use comma, semicolon, tab, or pipe separators. XLSX files can be up to 25 MB and 200,000 rows.
Yes. Choose the phone-number column and your browser extracts it, so only that column is uploaded; the other columns stay on your device. If your browser cannot extract it, we tell you before uploading the whole file, you choose the column from a preview, and we delete the original as soon as the phone column has been read. We return results in the same order, including empty rows, so you can copy them back to your master file.
It does not matter, but all of our results include a header row that identifies the datapoints in each column. Some customers want the rows in their source file to sync up perfectly with the result file rows, so if this is you, include a header row in your source file.
Yes. Blank rows stay in their original positions in the results so you can copy them back to your source file. Blank rows are not charged as lookups.
Yes. See the sample output files in our pricing grid.
We start processing automatically as soon as your payment is made. Most files take just a few minutes, while larger ones can take somewhat longer.
We use Stripe for payment processing. You can use a credit card or request a Stripe invoice.
Yes. For batch files, we automatically apply a 5% discount at 250,000 records and a 10% discount at 1 million records.
There is no limit on the number of lookups you can run. If you need to run over ten million records via batch, we ask that you give us a heads up first. At our API, there is a rate limit of 25 lookups per second. Please reach out if that's a problem and we can suggest the best options.
Number coverage and lookup results
We validate phone numbers from over 250 countries. Due to Canadian privacy law restrictions, information about Canadian numbers is based on the phone company and line type when the number was released; it is not updated for subsequent portability changes.
Our Line Type lookup works with Canadian phone numbers but due to Canadian privacy law does not include ported phone information and is based on the original Line Type, location and phone company at the time the number went into service.
Your numbers can be submitted with or without leading ones. For example, 13105551234 or 3105551234. The leading "1's" do not need to be consistent throughout your file. You may have them mixed within your file as well.
Yes, but when we return it to you, all punctuation will be removed.
It does not. Unfortunately, there is no standardized requirement on the phone companies to report their disconnected numbers. So, some may handle disconnects one way, others a different way. The result is there is no comprehensive way to determine if any given number is disconnected or not. Some services claim to offer a "disconnected" number search, but they are not definitive and are based on "likelihood". In other words, they are making educated guesses.
Fake or "invalid" phone numbers are numbers that have never been placed into service by the phone companies and cannot be called or texted. Examples would be 999-999-9999 and 123-456-7890 but there are tens of thousands of others. The most common reasons seen are for area codes that do not exist; area code and prefix combinations that do not exist; and finally, the area code and prefix combination is valid but the following 4 digits have not been placed into service by the phone companies.
A ported phone number is a phone number that has been redirected from its original phone company or line type. It allows people to keep their number known to family and friends when they need to change phone service. For example, a landline that was ported to a cell phone. Businesses who communicate to their customers really need to know the CURRENT line type, as opposed to the original line type so they don't accidentally call a cell phone that they thought was a landline. Our Line Type search includes a check of ported number data to identify phone numbers that have been ported. This is the most accurate way to identify the current true line type for any given phone number.
Possibly. Attempted text messages to landlines or VOIP numbers will make your bounce rate go up and this could contribute to platform penalties up to and including being de-platformed. By using our Line Type search, you can make sure texts don't go out to non-cell numbers.
API and compliance
Yes. See the API documentation.
Yes. Our “Batch by API” option processes a CSV file of phone numbers; the regular API handles individual lookups. There’s no limit on the number of phone numbers that can be in your CSV file. Your file must have phone numbers in Column A and all other columns must be empty. If you don’t have a free trial yet, sign up to get one, then read the Batch by API documentation. There is no minimum charge per batch when using our “Batch by API” option. The only cost is the cost of each lookup in your file.
We do not offer DNC scrubbing. Compliance with TCPA and similar laws is solely your responsibility. We cannot and do not provide legal advice.