Validate Email

Credits: 1 per call

Validates an email address by checking format, domain existence, MX records, disposable domain detection, free provider detection, role-based address detection, and risk scoring.

Request

GET /services/email/validate/{email}

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

string

required

The email address to validate.

curl -X GET "https://api.edge.bh/api/v1/services/email/validate/[email protected]" \
  -H "Authorization: Bearer sk_live_your_key_here"

import requests

response = requests.get(
    "https://api.edge.bh/api/v1/services/email/validate/[email protected]",
    headers={"Authorization": "Bearer sk_live_your_key_here"}
)

Response

{
  "email": "[email protected]",
  "valid": true,
  "checks": {
    "format": true,
    "domain_exists": true,
    "mx_records": true,
    "not_disposable": true,
    "domain_length": true,
    "local_length": true
  },
  "local_part": "john",
  "domain": "example.com",
  "mx_records": ["mx1.example.com", "mx2.example.com"],
  "disposable": false,
  "free_provider": false,
  "role_based": false,
  "score": 1.0,
  "risk": "none",
  "reason": null
}

Response fields

string

The normalized (lowercased, trimmed) email address.

boolean

Overall validation result. true if format is valid, domain exists or has MX records, and length checks pass.

object

Individual validation check results.

Show child attributes

boolean

Whether the email format is valid.

boolean

Whether the domain has A or AAAA DNS records.

boolean

Whether the domain has MX (mail exchange) records.

boolean

Whether the domain is NOT a known disposable/temporary email provider.

boolean

Whether the domain is 253 characters or fewer.

boolean

Whether the local part is 64 characters or fewer.

string

The part of the email before the @ symbol.

string

The domain part of the email address.

array

List of MX record hostnames for the domain. Empty array if none found.

boolean

Whether the domain is a known disposable/temporary email provider.

boolean

Whether the domain is a free email provider (e.g., gmail.com, yahoo.com).

boolean

Whether the email uses a role-based prefix (e.g., admin@, support@, info@).

number

Quality score from 0.0 (poor) to 1.0 (excellent). Calculated from: format (0.2), domain exists (0.2), MX records (0.3), not disposable (0.2), not role-based (0.1).

string

Risk level: high (disposable domain or non-existent domain), medium (no MX records), low (role-based address), or none.

string | null

Human-readable explanation for the risk level. null when risk is none.

Overview

Credits

IBAN Validation

Sanctions Screening

Exchange Rates

Bank Directory

Commercial Registry

Country Data

Email Validation

Phone Validation

Validate Email

Validate Email

Request

Response

Response fields

​Validate Email

​Request

​Response

​Response fields

Validate Email

Request

Response

Response fields