Ooredoo exposes a number-validation API used by their Quick Pay service to check mobile numbers before payment. It is a single unauthenticated GET request that returns the customer type for a given MSISDN.

The response determines which payment service to offer:

PRE (prepaid) → Raastas top-up only
POST (postpaid) → Ooredoo Bill Pay only
HYBRID → both Raastas and Ooredoo Bill Pay (user must choose)
No match → number is not an Ooredoo number

Base URL

https://www.ooredoo.mv

Authentication Model

No authentication required. The endpoint is publicly accessible.

Common Request Headers

No special headers are required. Standard HTTP/HTTPS headers apply.

Number Lookup Flow

Client                                       Server
  |                                            |
  |  GET /ooredoo-prod/QuickPayPackage/v1/     |
  |      numberTypeValidation                  |
  |      ?action=cust_details                  |
  |      &msisdn=9607654321                    |
  |------------------------------------------->|
  |  { custType: "PRE" }                       |
  |<-------------------------------------------|

Result Interpretation

`custType`	Meaning
`"PRE"`	Prepaid — offer Raastas top-up
`"POST"`	Postpaid — offer Ooredoo Bill Pay
`"HYBRID"`	Both prepaid and postpaid — offer both (user selects)
`null` / absent	Not an Ooredoo number

Applicable Numbers

Only Ooredoo mobile numbers are returned by this API. Ooredoo numbers in the Maldives start with 9 (7-digit local format, e.g. 9654321). The API expects the full MSISDN including country code 960.

Documents

#	File	Description
1	Number Validation	Validate an Ooredoo number and determine account type

Next → Number Validation