MailWiseBack to Home

API Documentation

Integrate MailWise's powerful AI email tools directly into your application. All endpoints require a `POST` method and a valid API key.

Validate Email
POST
/api/validate-email

Checks if an email address format is valid and likely deliverable.

Headers

{
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

Example Request Body

{
  "email": "user@example.com"
}

Example Success Response

{
  "isValid": true,
  "reason": null
}
Detect Fake Email
POST
/api/detect-fake-email

Uses AI to determine if an email address is likely algorithmically generated or suspicious.

Headers

{
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

Example Request Body

{
  "email": "suspicious-looking-email@mail.com"
}

Example Success Response

{
  "isFake": true,
  "reason": "The email address contains patterns often associated with temporary or fake email generators."
}
Detect Disposable Email
POST
/api/detect-disposable-email

Checks if an email address belongs to a known disposable or temporary email provider.

Headers

{
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

Example Request Body

{
  "email": "temp-mail@disposable.co"
}

Example Success Response

{
  "isDisposable": true,
  "reason": "The domain 'disposable.co' is a known disposable email provider."
}
Filter Domains
POST
/api/filter-domains

Filters a list of email addresses against a custom list of blocked domains.

Headers

{
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

Example Request Body

{
  "emailList": ["user1@good-domain.com", "user2@blocked-domain.com"],
  "domainList": ["blocked-domain.com"]
}

Example Success Response

{
  "filteredEmailList": [
    "user1@good-domain.com"
  ]
}