MImixrank
Email

Validate

Assesses an email address without guaranteeing deliverability. Cached and fetched assessments are billed separately. Timeout, malformed address, and cache miss return HTTP 200 assessments with validity temp_error, malformed, or uncached, respectively. With webhook, returns HTTP 202 and delivers the result asynchronously.

Required permissions for your API key's user: email.validate.

get/email/validate

Request

  • Base URL
    https://api.mixrank.com/v2/json/YOUR_API_KEY
  • Auth
    none declared

Query parameters

emailstring required

The email address to verify.

timeoutnumber

Synchronous validation timeout in seconds; ignored with webhook.

maxageinteger

Optional cache age in seconds, including for strict/besteffort. Without it, any cached result may qualify. Ignored by fetch.

strategy'cached' | 'fetch' | 'strict' | 'besteffort'

cached returns stored data only; fetch requests a refresh. strict uses sufficiently recent cached data, otherwise refreshes; besteffort also falls back to stale cached data when refresh fails.

webhookstring
<p>An <code>https</code> url to deliver the result to. Given one, the request is accepted with a <code>202</code> and a body of <code>{"id": ..., "status": "accepted"}</code> instead of waiting for the validation. The result is <code>POST</code>ed to this url as soon as it is ready.</p> <p>The body is <code>{"id": ..., "type": ..., "timestamp": ..., "data": ...}</code>, where <code>id</code> repeats the initial <code>id</code>, <code>type</code> names the event, <code>timestamp</code> is when the result was produced, and <code>data</code> carries the <code>status</code> the synchronous request would have answered with, and is otherwise the response you would have received synchronously, or an <code>error</code> message if it could not be answered.</p> <p>Deliveries follow <a href="https://github.com/standard-webhooks/standard-webhooks">Standard Webhooks</a>: each carries a <code>Webhook-Id</code> (which mirrors the body's <code>id</code>), a <code>Webhook-Timestamp</code> (unix seconds) and a <code>Webhook-Signature</code> header, the last formatted <code>v1,&lt;base64 hmac-sha256 of "&lt;id&gt;.&lt;timestamp&gt;.&lt;body&gt;"&gt;</code> and keyed with your api key, so any Standard Webhooks client can verify it. Reject a body whose signature does not match, and one whose timestamp is older than you are willing to accept. Delivery is retried with backoff until your endpoint answers <code>2xx</code>, and is abandoned after 10 attempts.</p>

Response

Successful response.

OR

Example response

{
  "email": "support@mixrank.com",
  "normalized": "support@mixrank.com",
  "validity": "valid",
  "validated_at": "2026-10-07T17:50:57.711722",
  "gateway": "google",
  "mx_records": [
    "aspmx.l.google.com",
    "alt1.aspmx.l.google.com",
    "alt2.aspmx.l.google.com",
    "aspmx2.googlemail.com",
    "aspmx3.googlemail.com"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.