Possible user input variants

For all requests, the country and in_phone input arguments will be used. The country input argument may be left blank if you precede the actual phone number with the country calling code in the in_phone input argument.

If desired, you can enter a list of phone numbers, provided they originate from the same country.

For user input, the following rules apply:

Country code

Each input requires a country code. You can specify the country code in two ways

  • in the country input argument or

  • if country is empty, enter the country calling code in the in_phone input argument using E.123 format. In E.123 format, the international country calling code is preceded by a + sign, serving as an international prefix symbol. Example for Germany: +49.

If you enter both a country code and a country calling code, the service will determine the country from the country calling code.

Fixed line numbers

You must always indicate the local area code. A variety of notations is supported for the input: For example, the local area code can be put in parentheses or not; the local area code can be entered with or without a leading zero; or there may be a blank between the local area code and the local number.

Permitted input combinations

Description Example

Country code local area code local number

country = de
in_phone = 072319361000

Country calling code local area code local number. It is important to write the country calling code according to E.123, i.e. using a plus sign and without leading zeroes. A different country calling code notation results in display of the ‘Invalid Number’ error message.

country =
in_phone = +49 (07231)9361000

Country code country calling code local area code local number

country =de
in_phone = +49 07231 9361000

Country code and a list of phone numbers You may also enter a semicolon or comma-separated list of phone numbers for the in_phone input argument. If you enter a list of numbers, always include the country code. It will apply to all numbers in the list.

country = de
in_phone = +49 07231 9361000;72319362020