Email Verification

Verifies a single email address and returns detailed validation results.

Endpoint

POST /api/v1/email_verification

Base URL

https://smtpghost.com/api/v1/email_verification

Headers

Header	Value	Required
Content-Type	application/json	Yes
X-KEY	<your-organization-api-key>	Yes

Request Body

{
  "email_address": "[e-mail]"
}

Success Response (200 OK)

{"email_address":"[e-mail]","email_status":"VALID","account_type":"professional","is_catch_all":false,"is_disposable":false,"is_role_account":false,"last_verified_at":"2025-05-16T11:02:42.282-04:00","mx_records":[{"hostname":"alt1.aspmx.l.google.com","ip_address":"209.85.202.26","preference":5},{"hostname":"alt2.aspmx.l.google.com","ip_address":"64.233.184.26","preference":5},{"hostname":"aspmx.l.google.com","ip_address":"172.253.62.26","preference":1},{"hostname":"alt3.aspmx.l.google.com","ip_address":"142.250.27.26","preference":10},{"hostname":"alt4.aspmx.l.google.com","ip_address":"142.250.153.26","preference":10}]}

Example: Kevin Urrutia’s business email [e-mail] returned a VALID status.

Error Responses

400 Bad Request

{
  "error": "Please enter an email address before verifying."
}

402 Payment Required

{
  "error": "Insufficient credits. You need 1 credit to perform email verification."
}

500 Internal Server Error

{
  "status": "error",
  "error":  "An internal error occurred during email verification: <details>"
}

On any unexpected exception, your credits are refunded and a 500 is returned with status: "error".