Integrating the MailChecker API

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 documentation

Request

HTTP / cURL
curl --get 'https://mailchecker.jrmania.com.br/v1/email/validate' \
  --data-urlencode '[email protected]' \
  --header 'X-API-Key: YOUR_API_KEY'

Illustrative response

JSON
{
  "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.

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.

Provide an email

Pass the address in the email parameter of GET /v1/email/validate.

Handle the response

Use decision, reason_code and validation signals to apply your application's policy.

Understanding the result

Inspect syntax, DNS/MX, disposable domain detection, SMTP status, cache usage and the decision reason. Field names stay the same in every language.

allow

Proceed

The validation found favorable signals.

warning

Review

A limitation or condition needs attention.

block

Block

The validation found a reason to block.

Handling errors

401
Missing or invalid key. Review authentication.
403
Administrative credentials cannot be used for public validation.
429
Request limit exceeded. Follow retry guidance.

Available response fields

Explore the full contract and test endpoints. Validating an address requires a valid key.

Open interactive documentation