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": "user@example.com"}

Response

{
  "success": true,
  "code": 200,
  "message": "Email validation complete",
  "data": {
    "email": "user@example.com",
    "valid": true,
    "syntax_valid": true,
    "mx_valid": true,
    "disposable": false,
    "domain": "example.com",
    "normalized": "user@example.com",
    "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

Cost: 1 credit per request

Usage Pattern

1. Use $APIPICK_API_KEY env var as the x-api-key header value; if not set, ask the user for their apipick API key
2. Make the POST request with the email address
3. Report the valid status and flag if disposable is true
4. Show reason when validation fails

See references/api_reference.md for full response field descriptions.