Validate Phone

Credits: 1 per call

Validates a phone number and returns formatting information, country detection, line type (mobile/landline), and E.164 formatted number.

Request

GET /services/phone/validate/{phone}

Both GET and POST methods are supported. For POST, pass the phone number in the request body.

string

required

The phone number to validate. Include country calling code (with +) for best results.

curl -X GET "https://api.edge.bh/api/v1/services/phone/validate/+97317000000" \
  -H "Authorization: Bearer sk_live_your_key_here"

import requests

response = requests.get(
    "https://api.edge.bh/api/v1/services/phone/validate/+97317000000",
    headers={"Authorization": "Bearer sk_live_your_key_here"}
)

Response

{
  "phone": "+97317000000",
  "valid": true,
  "e164": "+97317000000",
  "international": "+973 17000000",
  "national_number": "17000000",
  "calling_code": "+973",
  "country_code": "BH",
  "type": "landline",
  "checks": {
    "format": true,
    "country_detected": true,
    "valid_length": true
  },
  "reason": null
}

Response fields

string

The original phone number as provided.

boolean

Whether the phone number is valid (country detected and length matches expected format).

string | null

E.164 formatted number (e.g., +97317000000). Recommended format for storage. null if country could not be detected.

string | null

International format with space after calling code (e.g., +973 17000000). null if country could not be detected.

string | null

The national number without the calling code. null if country could not be detected.

string | null

The detected calling code with + prefix (e.g., +973). null if not detected.

string | null

ISO 3166-1 alpha-2 country code (e.g., BH). null if country could not be detected.

string

Line type: mobile, landline, or unknown.

object

Individual validation check results.

Show child attributes

boolean

Whether the number has between 7 and 15 digits.

boolean

Whether a country was detected from the calling code.

boolean

Whether the national number length matches the expected length for the detected country.

string | null

Human-readable explanation when the number is invalid. null when valid.

Overview

Credits

IBAN Validation

Sanctions Screening

Exchange Rates

Bank Directory

Commercial Registry

Country Data

Email Validation

Phone Validation

Validate Phone

Validate Phone

Request

Response

Response fields

​Validate Phone

​Request

​Response

​Response fields

Validate Phone

Request

Response

Response fields