Number validator
    • 13 Mar 2024
    • 6 Minutes to read
    • Dark
    • PDF

    Number validator

    • Dark
    • PDF

    Article summary

    Who should read this article: Administrators

    Bulk lookup of phone numbers to ensure they are valid before using them for outbound dialing. Choose either the Number profile or Line activity option.


    The Number validator service helps you prepare for outbound calling campaigns, whether you use the Dialer or manual dialing or whenever you need to check the validity of phone numbers. Use the Number validator provides the following services:

    • Checks that your numbers have a valid format
    • Verifies that your numbers are allocated to mobile operators and subscribers
    • Reports on whether your numbers are available to receive calls
    • Provides additional details about your numbers

    Voiso offers you two options to verify numbers, Number profile and Line activity. The Line activity option includes all the details obtained through the Number profile option, plus information about mobile number availability status and roaming registration.

    The Number validator generates a CSV file that includes your original number, along with a set of fields that contain the results of the Number profile or Line activity operations.

    Number profile

    The following table describes the fields in the output CSV file:

    FieldDescriptionPossible value or content type
    countryCountry nametext
    originalThe calling list number to be validatednumber
    localThe phone number in the national phone number format for the countrylocally formatted phone number
    e164The phone number in the international E.164 number format (+)E.164 formatted phone number
    is_validResult of number format validation checkYES or NO
    allocated_rangeWhether or not the number is allocated to a Service Provider (a valid service)YES or NO
    number_typeWhether the number type is landline (landed), mobile, or a servicelandline, mobile, or service
    current_carrierThe operator name serving the numbertext
    is_reachable(used for Line activity only)YES, NO, or -
    in_roaming(used for Line activity only)YES, NO, or -
    is_portedWhether or not the number ported from another providerYES or NO
    risky_destinationWhether or not a number has been flagged by any telecom operators or their customersYES, NO, or -
    country_codeThe two-letter alpha-2 country codes defined in ISO 3166‑1text
    mccThe Mobile Country Code for the numbernumber
    mncThe Mobile Network Code (home network identity) of the network in a countrynumber
    timezoneThe time zone of the numberUTC+00:00
    costThe cost to analyze the number. Numbers that are from countries or mobile networks that do not provide line activity information are charged at a lower rate.U.S. dollars

    Line activity

    The Line activity operation outputs the same fields as the Number profile operation and includes information about reachability and roaming status. The following table describes the Line activity-specific fields in the output CSV file:

    FieldDescriptionPossible value or content type
    is_reachableThe number is in the coverage areaYES, NO, or -
    in_roamingThe number is roaming outside of the coverage areaYES, NO, or -

    Preparing your numbers for validation

    The Number validator requires a CSV file of phone numbers as input. There should be one phone number per line. No header line is required. Only numbers are supported. The service ignores any line with letters or special characters. A '+' symbol may appear at the beginning of a phone number; however, the symbol is removed in the output file. Entries that are not legitimate phone numbers are not included in cost calculations.

    Using the Number validator

    To access the Number validator, from the Voiso navigation bar, navigate to Outbound > Number validator.

    The Number validator page displays a sortable table of all the validation requests you have created. Each request includes the date it was created, how many numbers were checked, and the status of the request. Statuses include In progress, Error, and Completed.

    Outbound Number Validator Page

    Click a completed request or a request with an error to view the request details. To review the validation results, click Download report to download a CSV of the results. Refer to Number profile and Line activity sections for a description of the fields of the results CSV file. You can also download a record of your original numbers.

    Outbound Number Validator Page Request Details

    The Request details panel includes the following information:

    Created onThe date and time the request was made
    Requested byThe name of the user who made the request
    StatusCompleted or Error
    Numbers validatedThe count of numbers that were validated. This number does not include entries that contained unsupported characters or were not in E.164 format.
    Invalid numbersThe count of numbers that could not be validated.
    Unallocated numbersThe count of number that are allocated to a Service Provider (a valid service)
    Total costThe total charges for the Number profile and Line activity validation reports.

    Making a validation request

    To validate a list of numbers follow these steps:

    1. From the Voiso navigation bar, navigate to Outbound > Number validator.
    2. Click Add validation request.
    3. Drag and drop or browse to your correctly formatted CSV file containing a list of phone numbers (1). When a list of numbers is uploaded, the service automatically performs a preliminary verification to identify typographical errors and estimate the cost of validating all the numbers in the request.
    4. Select one of the following options:
      1. Number profile (2): The cost per number is specified in the Number profile box
      2. Line activity (3): The cost per number is specified in the Number profile box
    5. Review the total cost for the validation request (4). The cost is the sum of the individual costs per number specified by the validation request type. For a Line activity request, numbers from service providers or countries that do not provide line activity information are charged at the Number profile rate instead.
    6. Click Validate (5).
    7. The validation begins. A notice is displayed when the process is complete.
    8. A second notice displays when your report is available to download. Click the link in the notice to download the report or navigate to the Number validator page and click the entry for the request to review the Request details.

    Outbound Number Validator Validation Request Page

    Was this article helpful?