Skip to main content
POST
Number Portability Check
Mobile Number Portability (MNP) lets a subscriber keep their number while switching network operators. A number whose current operator differs from its homeOperator has been ported.A recent or unexpected port can be a fraud signal — porting is a known vector for account takeover (an attacker ports a victim’s number to a SIM they control). Use this check as a pre-authentication risk layer for sensitive flows.
The portability result is carried by phoneDetail.isPorted; there is no separate top-level result field. When success is false, phoneDetail may be omitted.
phoneDetail contains enriched metadata about the phone number — including operator, country, line type, and time zones. All fields are omitted when not available for the given number or operator.

Authorizations

clientId
string
header
required

OTPless API Client ID

clientSecret
string
header
required

OTPless API Client Secret

Body

application/json
phoneNumber
string
required

Phone number including country code, without plus sign. Example: 917020141726 for +91 70201 41726.

Example:

"917020141726"

Response

HTTP 200 — Request accepted. Inspect success in the body:

  • success: true — Check completed. Use phoneDetail.isPorted to determine the result.
  • success: false — Check could not be completed. Inspect error for details.
success
boolean
required

true if the check completed successfully. false if the check could not be completed — inspect the error object for details.

phoneDetail
object

Enriched phone metadata. Fields are omitted when not available for the given number or operator.

error
object

Error object returned inside a 200 response when success is false.