add docs for ported numbers

2026-05-17 00:32:34 +05:00
parent ccc9e11d55
commit bb2c4f0158
4 changed files with 33 additions and 3 deletions
@@ -161,7 +161,16 @@ If the nonce is missing, invalid, or has already been used, the server returns a
 |---|---|
 | `"Y"` | Dhiraagu Reload |
 | `"N"` | Dhiraagu Bill Pay |
-| absent / other | Unsupported — fall back to Ooredoo lookup |
+| absent / `respStatus != "OK"` | Unsupported — fall back to Ooredoo lookup |
+
+## Number Portability
+
+Due to **mobile number portability (MNP)** in the Maldives, a subscriber can port their number between Dhiraagu and Ooredoo while keeping the same number. This means:
+
+- A number starting with **9** (typically Ooredoo) may now be on the Dhiraagu network.
+- A number starting with **7** (typically Dhiraagu) may now be on the Ooredoo network.
+
+Always fall back to the other provider's lookup if this API returns a failed/unsupported result, regardless of the number prefix.

 ---

@@ -81,7 +81,13 @@ Client                                      Server

 ## Applicable Numbers

-Only Dhiraagu mobile numbers are returned by this API. Dhiraagu numbers in the Maldives start with **7** (7-digit local format, e.g. `7654321`).
+Dhiraagu numbers in the Maldives typically start with **7**, but due to **mobile number portability (MNP)**, a subscriber may have ported their number from Ooredoo (originally a 9xxx number) to Dhiraagu — or vice versa. The number prefix alone does not reliably identify the current provider.
+
+For this reason, both providers should be tried when looking up an unknown number:
+- If the number starts with **7**, try Dhiraagu first; fall back to Ooredoo if Dhiraagu returns a failed status.
+- If the number starts with **9**, try Ooredoo first; fall back to Dhiraagu if Ooredoo returns no match.
+
+The API only returns a valid result for numbers currently on the Dhiraagu network, regardless of what prefix they carry.

 ---