phone

KeyFormatConditionDescription
countryCodestringMCountry code according to ITU-T E.164. Numbers only. No leading zeros.
subscriberNumberstringMNational number according to ITU-T E.164 including national destination code. Numbers only. No leading zeros.

International ITU-T E.164-number structure for geographic areas

The international ITU-T E.164 phone number is arranged in two code fields:

  • the country code (CC) and
  • the national (significant) number N(S)N.

The national (significant) number may be further subdivided into national destination code (NDC) and subscriber number (SN).

The NDC, often known as area code, is of variable length depending on the country code. The NDC is

  • four digits of the N(S)N in the case of a country with a three-digit country code;
  • five digits of the N(S)N in the case of a country with a two-digit country code;

six digits of the N(S)N in the case of a country with a one-digit country code.

Schema

{

    “$schema”: “http://json-schema.org/draft-07/schema#”,

    “$id”: “https://www.computop-paygate.com/schemas/phone.json”,

    “title”: “Phone”,

    “description”: “Telefonnummer”,

    “type”: “object”,

    “properties”: {

        “countryCode”: {

            “type”: “string”,

            “minLength”: 1,

            “maxLenght”: 3

        },

        “subscriberNumber”: {

            “type”: “string”,

            “maxLenght”: 15

        }

    },

    “required”: [“countryCode”, “subscriberNumber”],

    “additionalProperties”: false

}

Sample

{

  “countryCode”: “33”,

  “subscriberNumber”: “12345678910”

}