Interface information

tyntec’s Global Number Portability (GNP) resolves number portability by obtaining data directly from local number portability databases and live network information from across the globe.

Global Number Portability is available with the Synchronous SOAP API.

SOAP is a protocol used for exchanging messages over a computer network. The messages that are sent do not rely on the underlying transport protocol, which is in most cases HTTP (and in the specific case of the tyntec infrastructure).

The messages themselves are structured as XML documents and are defined in two parts:

To implement and use Global Number Portability, you should have the call of a Web Service as defined by the SOAP specification ( with the help of the provided WSDL file.

Furthermore, you need a computer system with a fixed IP address from where the SOAP call is initiated. This computer system must be reachable from the tyntec IP. For the fastest implementation and expert support from tyntec, it is strongly recommended that the Global Number Portability is implemented using:

The following documents are useful in implementing the Global Number Portability service with the above components:

 This is the overview of the workflow for querying portability information:


As previously mentioned, tyntec’s SOAP implementation uses HTTP as its transport layer. The initial request consists of the number to be queried, in international format. The result will contain:

Subscription network information

  • IMSI network information (MCC/MNC)
  • IMSI country
  • IMSI time zone
  • HLR network information (MCC/MNC)
  • HLR country
  • HLR time zone