Skip to content

Back to guides

Preparing a number file: format, country codes, duplicates

A well-prepared number file gives you an accurate quote and results that are easy to check. Here is what to check before you upload.

File format

  • A UTF-8 encoded TXT or CSV file.
  • One column only, with no header and no other columns.
  • One number per line.
  • Up to 100 MB and 5 million lines per file.
  • XLSX and ZIP are not supported. Save Excel lists as CSV (UTF-8).

For short lists you can also paste the numbers on the order page.

Include the country code

Write every number in international format with its country code, such as 447700900123 or +447700900123; the leading + is optional. A number in local format, without the country code or starting with 0, cannot be matched to a country and counts as malformed.

Numbers from mainland China (+86) are not supported. The North America carrier lookup takes +1 numbers only.

Deduplication and validation shape the quote

Before quoting, duplicates are removed and every number is validated. The quote counts only unique numbers that pass validation, and malformed numbers are free. Duplicates or bad rows will not cost you anything, but the quoted count can be lower than the number of lines in your file. That is expected.

Every service has a minimum quantity, and an order below it after deduplication is rejected. Minimums are listed on the pricing page.

One service per order

Each order runs one service. To check one list on several platforms, upload it once and place a separate order for each.

See the FAQ for more.

Ready to verify your next number batch?

Contact support to open an account, then upload number lists, preview deduplicated quotes, and download categorized CSV outputs.