Galon Cloud
Galon API v1

/email-validations

Base URL https://api.galon.ai/v1 · export GALON_API_BASE="https://api.galon.ai/v1"

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

NameInTypeDescription
Idempotency-Keyheaderstring

Request body

application/json · schema EmailValidationRequest

Responses

StatusDescriptionBody
200An email_validation object for {email}; {object: list, data} in the order received for {emails}EmailValidation | EmailValidationList
400body_invalid, idempotency_key_invalid
401Key missing or invalidError
403scope_missing: scope validation:check missing
404not_found: service not open to this account
409idempotency_conflict
413Body larger than 128 KiB
422validation_request_invalid, validation_batch_empty, validation_batch_too_large
429rate_limited (Retry-After)
503validation_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"}'