Service Specification

How to Access the Service

Customers access our service by querying to XConnect’s Global Points of Presence (PoPs). We support access via HTTPS, SIP and ENUM query protocols.

Further details for each protocol can be found in the following documents:

ENUM Interface Spec

HTTPS Interface Spec

SIP Interface Spec

Fields and Response Codes

Find out what each of our response codes mean.

Query Customisation

XConnect can provide rapid query customisation through our SMART rules engine, which allows bespoke queries to be created by selecting desired response attributes and combining multiple queries with filters and decision trees.

Service Examples

Our Latest Thoughts And News on All Things Communication

15 October 2025

News

The man who invented mobile identity APIs has a new mission

02 September 2025

Resource

VPNs, Age Verification and the Trouble with Location-Based Checks

The Ship of Theseus and Identity in the Agentic AI world

02 September 2025

Resource

The Ship of Theseus and Identity in the Agentic AI world

Service Name	Description	Example using curl	Coverage
Valid	Checks specific number to determine if it belongs to an existing range	curl -u -k -X GET “https://lookup2.xconnect.net/pi/?service=valid” tn:<TELEPHONE_NUMBER> nt:<NUMBER_TYPE> cc: <ISO_COUNTRY> cic: <CARRIER_IDENTIFICATION_CODE> cn: <CARRIER_NAME> mcc: <MOBILE_COUNTRY_CODE> mnc: <MOBILE_NETWORK_CODE> rn: <ROUTING_NUMBER>	Global
Allocated	Checks specific number HLR data to determine if associated with an active subscriber	curl -u -k -X GET “https://lookup2.xconnect.net/pi/?service=allocated” tn: <TELEPHONE_NUMBER> nt: <NUMBER_TYPE> cc: <ISO_COUNTRY> cic: <CARRIER_IDENTIFICATION_CODE> cn: <CARRIER_NAME> mcc: <MOBILE_COUNTRY_CODE> mnc: <MOBILE_NETWORK_CODE> rn: <ROUTING_NUMBER> npdi: <NUMBER PORTABILITY DIP INDICATOR> npi: <NUMBER PORTED INDICATOR>	Global, subject to variability. XConnect proactively test and manage a global network of HLR Lookup suppliers. Daily baseline tests are performed to check for availability and response accuracy and the best providers are activated for each mobile network.
Reachable	Checks if specific number has a reachable/presence status as defined by an HLR response	curl -u -k -X GET “https://lookup2.xconnect.net/pi/?service=reachable”	In development.

Service Name	Description	Example using curl	Coverage
NPQ-GC	Returns information about the Service Provider which currently serves the queried Telephone Number, taking into account Number Portability.	curl -k -X GET https://lookup.xconnect.net/query/972525441***?service=npq	Global. SLA’s vary according to country. Contact sales for more detailed information.

Service Name	Description	Example using curl	Coverage
GNR	Returns information about the Service Provider which ‘owns’ the Number Range (Carrier of Record)	curl -k -X GET https://lookup.xconnect.net/query/12017773***?service=gnr	Global.

Service Name	Description	Example using curl	Coverage
NPQ-LIVE	Returns information about the Service Provider which currently serves the queried Telephone Number, taking into account Number Portability.	curl -k -X GET https://lookup.xconnect.net/query/12017773***?service=gnr	Global, subject to variability. XConnect proactively test and manage a global network of HLR Lookup suppliers. Daily baseline tests are performed to check for availability and response accuracy and the best providers are activated for each mobile network.