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
@@ -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.

 ---