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 Asynchronous 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:

  • SOAP standard
    The SOAP standard describes elements necessary for communication, such as the “SOAP Envelope,” which encloses the actual content to be sent. This content is application-specific and is in this case defined by the WSDL file provided by tyntec. A simple XML parser can be used for extracting the data from the soap response.

To implement and use Global Number Portability, you should have the following resources available:

  • The call of a Web Service as defined by the SOAP specification ( with the help of the provided WSDL file.
  • A receiving Web Service on the server side to accept requests to deliver the results (CheckDeliverRequest, defined in the WSDL file).

Furthermore, you need a computer system with a fixed IP address from where the SOAP call is initiated, where the Web Service runs and which accepts the results if using the asynchronous API (Check Delivery Requests). This computer system must be reachable from the tyntec IP. For the fastest implementation and expert support from tyntec, we recommend implementing the GNP using:

 The following links to 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