Skip to main content

MNP Customer APIs

The HORISEN MNP Customer APIs enable carriers, aggregators, and enterprise service providers to query mobile number portability information in real-time. These APIs provide fast, accurate operator resolution for MSISDNs, helping you optimize message routing, reduce costs, and improve delivery performance.

Access MNP data through multiple protocol options to match your integration requirements.

The MNP HTTP API (v2.0) is a synchronous, JSON-based query interface: send an MSISDN together with your account username and password to the query endpoint, and receive the MCC/MNC of the current operator in the response, along with ported, roaming, valid, and online indicators. Adding the optional opinfo parameter also returns the country and operator name.

For customers who prefer DNS-based resolution, the MNP Customer ENUM API exposes MCC/MNC operator resolution through NAPTR lookups: the MSISDN is reversed, dot-separated, and queried as a domain name against HORISEN's ENUM server, returning MCC, MNC, service provider ID (spid), and a number-portability dip indicator (npdi) in the NAPTR record — a narrower field set than the HTTP API's ported/roaming/valid/online indicators.