Skip to main content
POST
Says whether an email address can receive mail.

Authorizations

Authorization
string
header
required

API key. Send Authorization: Bearer rtr_live_… or rtr_test_…

Body

application/json

Says whether an email address can receive mail.

email
string
required
routing
CapabilityRouting · object

CapabilityRouting

max_credits
integer<int32>

Stop the plan before a step that would exceed this many credits.

timeout_ms
integer<int32>

How long each vendor may take, in milliseconds. When the time is up, routr tries the next vendor and does not charge for that step. Omit it to use each vendor's own timeout. Example: 3000.

Response

200 - application/json

Success

EmailValidateResponse

id
string

Call ID. The same ID is returned when an Idempotency-Key is replayed.

result
EmailValidateResult · object

EmailValidateResult

resolved_by
string

Integration that produced a conclusive verdict. Null when none did.

steps
CapabilityStep · object[]

Steps that ran, in order.

credits_charged
integer<int32>

Credits charged for this call. A replay returns the original value.

cached
boolean

True when the result was served from the cache. Always false in this version.

credits_remaining
integer<int32>

Account balance right after this call settled. A replay returns the value from the first response.

stop_reason
string

Why the call stopped: conclusive, plan_end, or max_credits.

response_status
ResponseStatus · object

ResponseStatus