POST /email-validations
Validate email addresses (syntax, role, disposable domain, typo, MX)
One address ({email}) or a batch of 1 to 100 ({emails}). Verdict per address: valid, risky, invalid or unknown, with named reasons (reasons). Checks: practical RFC 5321/5322 syntax and internationalised domains (IDN), normalisation, role address, disposable domain, probable typo on the major providers (offered in suggestion, never applied), MX records (missing with A/AAAA fallback, null MX, non-existent domain). No SMTP connection is opened to the recipients' servers: the existence of the mailbox itself is not verified. valid requires an MX record and no risk reason; unknown indicates a DNS that did not respond in time. Scope validation:check; 1 000 addresses per minute per key. Optional Idempotency-Key: the same request replayed under the same key returns the same response (header Idempotent-Replayed: true).
API key (Bearer), on the public API endpoint.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
Idempotency-Key | header | string |
Request body
application/json · schema EmailValidationRequest
Responses
| Status | Description | Body |
|---|---|---|
200 | An email_validation object for {email}; {object: list, data} in the order received for {emails} | EmailValidation | EmailValidationList |
400 | body_invalid, idempotency_key_invalid | |
401 | Key missing or invalid | Error |
403 | scope_missing: scope validation:check missing | |
404 | not_found: service not open to this account | |
409 | idempotency_conflict | |
413 | Body larger than 128 KiB | |
422 | validation_request_invalid, validation_batch_empty, validation_batch_too_large | |
429 | rate_limited (Retry-After) | |
503 | validation_unavailable, platform_unavailable |
Examples
curl
curl -X POST "$GALON_API_BASE/email-validations" \
-H "Authorization: Bearer $GALON_API_KEY" \
-H "Idempotency-Key: <unique-key>" \
-H "Content-Type: application/json" \
-d '{"email": "string"}'