apipick-email-checker
v1.0.0Validate email addresses using the apipick Email Validator API. Performs syntax checking, MX record verification, and disposable/throwaway email detection. Use when the user wants to verify an email address, check if an email domain exists and can receive mail, detect disposable or temporary emails,...
Installation
apipick Email Validator
Validate email addresses with syntax check, MX record lookup, and disposable email detection.
Endpoint
POST https://www.apipick.com/api/check-email
Authentication: x-api-key: YOUR_API_KEY header required.
Get a free API key at https://www.apipick.com/dashboard/api-keys
Request
{"email": "[email protected]"}
Response
{
"success": true,
"code": 200,
"message": "Email validation complete",
"data": {
"email": "[email protected]",
"valid": true,
"syntax_valid": true,
"mx_valid": true,
"disposable": false,
"domain": "example.com",
"normalized": "[email protected]",
"reason": null
},
"credits_used": 1,
"remaining_credits": 99
}
Key fields:
- valid: true only when both syntax_valid AND mx_valid are true
- disposable: true if the domain is a known throwaway email service
- reason: explanation when validation fails (null on success)
- normalized: canonical lowercase form of the email
Error Codes
| Code | Meaning |
|---|---|
| 400 | Invalid request |
| 401 | Missing or invalid API key |
| 402 | Insufficient credits |
Cost: 1 credit per request
Usage Pattern
- Use
$APIPICK_API_KEYenv var as thex-api-keyheader value; if not set, ask the user for their apipick API key - Make the POST request with the email address
- Report the
validstatus and flag ifdisposableis true - Show
reasonwhen validation fails
See references/api_reference.md for full response field descriptions.