Authenticate the request
Send your key in the X-API-Key header. Use it on your server and keep the secret out of public code.
Send the address and your API key in an HTTP request. The JSON response includes the result of each check and the reason for the recommendation.
Open interactive documentationcurl --get 'https://mailchecker.jrmania.com.br/v1/email/validate' \
--data-urlencode '[email protected]' \
--header 'X-API-Key: YOUR_API_KEY'{
"decision": "allow",
"risk_score": 10,
"reason_code": "VALID",
"syntax": { "valid": true },
"dns_mx": { "mx_found": true },
"disposable": { "is_disposable": false },
"smtp": { "status": "pass" }
}Validation does not guarantee message delivery.
Send your key in the X-API-Key header. Use it on your server and keep the secret out of public code.
Pass the address in the email parameter of GET /v1/email/validate.
Use decision, reason_code and validation signals to apply your application's policy.
Inspect syntax, DNS/MX, disposable domain detection, SMTP status, cache usage and the decision reason. Field names stay the same in every language.
allowThe validation found favorable signals.
warningA limitation or condition needs attention.
blockThe validation found a reason to block.
401403429Explore the full contract and test endpoints. Validating an address requires a valid key.