How to Set Up MNP HLR for a Client?

When a client's traffic goes to an MNP country, the platform needs to know which operator actually holds the number — not just the original operator assigned by prefix. You can configure a client price to check each number against the MNP database or via an HLR request before routing the SMS. This ensures the correct route and price are applied based on the number's current operator.

Before You Start

To use HLR checking, you need to create an HLR route for the client in addition to the SMS price. The HLR route tells the platform which aggregator to use for the lookup. No HLR price is required — the cost of the HLR should already be factored into the SMS price you charge the client.

To use MNP database checking, the MNP database for the relevant country must already be loaded on the platform. Contact Gatum support to set this up.

Set Up HLR/MNP Checking for a Client

Step 1: Create an HLR Route

Go to Profiles → Clients.

Click the client's name to open their profile.

Open the Destinations tab. In the Personal routing section,

In the Personal routing section, click Create.

In the window that opens:

Fill in the fields:

Click Create.

Step 2: Enable HLR/MNP Checking on the Client Price

In the Prices section of the client's Destinations tab, click Create to add a new price or Show all to open a full list of prices.

In the window that opens:

Fill in the fields:

Click Update.

Once saved, every SMS sent by this client to the configured destination will be checked before routing. Note that HLR checking reduces sending speed to approximately 10–50 SMS/sec, so it is best suited for lower-volume traffic. MNP database checking has no impact on sending speed.