MailConfirmed API Documentation

1. Email Validation Endpoint

HTTP GET https://mailconfirmed.p.rapidapi.com/email-validation/{email}

Validates an email address, checking for format, disposability, role-based use, and assigns a score. Examples:

Request Example:

https://mailconfirmed.p.rapidapi.com/email-validation/somename@example-domain.com

Successful Response:

{
    "email": "somename@example-domain.com",
    "isValidFormat": true,
    "isDisposable": false,
    "isDnsValid": true,
    "isSuspicious": false,
    "isRoleBased": false,
    "score": 99,
    "suggestedAction": "allow"
}

Unsuccessful Request Example:

https://mailconfirmed.p.rapidapi.com/email-validation/support@example.com

Unsuccessful Response:

{
    "email": "support@example.com",
    "isValidFormat": true,
    "isDisposable": false,
    "isDnsValid": true,
    "isSuspicious": true,
    "isRoleBased": true,
    "score": 72,
    "suggestedAction": "deny"
}

2. Disposable Email Validation Endpoint

HTTP GET https://mailconfirmed.p.rapidapi.com/{email}/disposable

Checks whether the provided email address is from a disposable email provider, often used for temporary or anonymous purposes. It returns a simple boolean indicating whether the email is disposable.

Request Example:

https://mailconfirmed.p.rapidapi.com/email-validation/someone@temporarymail.com/disposable

Successful Response:

{
    "email": "someone@temporarymail.com",
    "isDisposable": true
}

3. Email Format Validation Endpoint

HTTP GET https://mailconfirmed.p.rapidapi.com/email-validation/{email}/valid-format

Validates the format of the provided email address, ensuring that it adheres to standard email syntax (e.g., user@example.com) and checks the validity of its structure, including the domain and top-level domain (TLD).

Request Example:

https://mailconfirmed.p.rapidapi.com/email-validation/validuser@example.com/valid-format

Successful Response:

{
    "email": "validuser@example.com",
    "isValidFormat": true
}

4. Bulk Email Format Validation Endpoint

HTTP POST https://mailconfirmed.p.rapidapi.com/email-validation/valid-format

Validates the format of multiple email addresses in a single request. Ensures each email adheres to standard email syntax (e.g., user@example.com) and checks the validity of their structure, including domains and top-level domains (TLDs).

Request Example:

[
    "email1@example.com",
    "email2@domain.com",
    "@email3.com"
]

Successful Response:

[
    {"email": "email1@example.com", "isValidFormat": true},
    {"email": "email2@domain.com", "isValidFormat": false},
    {"email": "@email3.com", "isValidFormat": false}
]

5. Bulk Disposable Email Validation Endpoint

HTTP POST https://mailconfirmed.p.rapidapi.com/email-validation/disposable

Checks whether multiple email addresses are from disposable email providers in a single request. Returns a simple boolean for each email indicating whether it is disposable.

Request Example:

[
    "email1@example.com",
    "email2@domain.com",
    "email3@temp.com"
]

Successful Response:

[
    {"email": "email1@example.com", "isDisposable": false},
    {"email": "email2@domain.com", "isDisposable": false},
    {"email": "email3@temp.com", "isDisposable": true}
]