ENUM Interface

Overview

ENUM stands for Electronic Numbering Mapping. With it, you can translate telephone numbers in E.164 format into a format that can be used in Internet communications.

---

How ENUM Works

The ENUM protocol converts telephone numbers to DNS-compatible format through a sequential process:

1

Remove non-digit characters

Strip any characters that are not digits from the phone number.

2

Add dots between digits

Insert a dot between each digit.

3

Reverse the order of the digits

Reverse the digit sequence.

4

Append domain

Add the domain e164.arpa to the end.

Conversion Example

Original number: [phone]

Result: 2.1.0.9.8.7.6.5.4.3.2.1.e164.arpa.

---

Authentication

ENUM API queries require authentication to identify the client, return appropriate results and ensure security.

Authentication is based on the client's IP address and the port used during the query.

Important: Prior to using the ENUM API (in both test and production environments), the client should submit a list of IP addresses to their account manager for authentication purposes.

---

Server Connections

Service	Host:Port
Primary MNP	141.95.255.235:5003
Primary HLR	141.95.255.235:5001
Test MNP	141.95.255.235:5004
Test HLR	141.95.255.235:5002

---

Query Format

General Syntax

dig @{SERVER_IP} -p {PORT} -t naptr {REVERSED_NUMBER}.e164.arpa

Parameters:

• {SERVER_IP} - ENUM server IP address (141.95.255.235)

• {PORT} - Service port (see Server Connections table)

• {REVERSED_NUMBER} - Phone number reversed and dot-separated

---

MNP Lookup via ENUM

Query Examples

Production:

dig @141.95.255.235 -p 5003 -t naptr 2.1.0.9.8.7.6.5.4.3.2.1.e164.arpa

Testing:

dig @141.95.255.235 -p 5004 -t naptr 2.1.0.9.8.7.6.5.4.3.2.1.e164.arpa

MNP Response Fields

Field	Type	Description
mcc	string	Mobile Country Code
mnc	string	Mobile Network Code
ported	boolean	Number portability status

---

Number Verifier (HLR) via ENUM

Query Examples

Production:

dig @141.95.255.235 -p 5001 -t naptr 2.1.0.9.8.7.6.5.4.3.2.1.e164.arpa

Testing:

dig @141.95.255.235 -p 5002 -t naptr 2.1.0.9.8.7.6.5.4.3.2.1.e164.arpa

HLR Response Fields

Field	Description
error or result	Result code (1 = success)
country_name	Country name
brand	Operator brand
brand_name	Operator brand name
msisdn	Phone number
network	Network information
status	Subscriber status

---

Result Codes

All successful requests have a code: result=1.

All requests with errors have a code: error=1 and error description.

---

Testing Environment

Test endpoints are available for verifying your ENUM API integration. They let you check authorization, connectivity, and correct query/response formatting.