MImixrank
Email

Get Prospect

Discovers or generates candidate email addresses. Requires person_id, or domain plus at least one of full_name, first_name, or last_name. Billing is per returned email. With webhook, returns HTTP 202 and delivers the result asynchronously.

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

get/email/prospect

Request

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

Query parameters

full_namestring

Full name.

first_namestring

First name.

last_namestring

Last name.

person_idinteger

MixRank person ID, as returned by the person search or lookup endpoints.

domainstring

Company domain without a scheme or path.

limitinteger

Set a limit on the number of emails returned.

check_ownership't' | 'f'

When given a Person ID, attempt to exclude emails that belong to persons with similar names.

skip_sv't' | 'f'

Experimental parameter. When given a Person ID, attempt to exclude side ventures from positions.

keep_ambiguous't' | 'f'

When given a Person ID and no email is flagged valid, keep linked emails flagged ambiguous.

downscore_edu't' | 'f'

Only consider educational (.edu) emails once every other candidate has been exhausted.

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 prospecting, which can take a while. 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

{
  "name": "support",
  "emails": [
    {
      "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.