Email finder

Find a work email

A person's name and company domain in, their work email out. 1 credit when the address is found and confirmed (valid). 1 credit when the domain accepts every address (catch_all); the most likely address comes back with confirmed: false. 0.25 credits when nothing is found. Free when the input is invalid, the domain has no email (no_mail_domain) or its mail server cannot be reached right now (retry_later). For more than a handful of people, start a list job.

The first lookup that finds nothing takes 1 credit and keeps 0.75 for the next three such lookups, so each costs 0.25.

CostWhat it doesKey scopes
1 credit when found, 0.25 credits when nothing is found; bad input, domains without email and unreachable mail servers are freeSpends creditsargorant:unlock_contacts
post/api/v1/email-finder/find

Request

  • Base URL: https://app.argorant.com
  • URL: https://app.argorant.com/api/v1/email-finder/find
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.

X-Request-Idstring

Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.

Request body

first_namestring

First name.

last_namestring

Last name.

namestring

Full name instead of first_name and last_name; titles are ignored.

domainstring required

The company domain. A website URL or an email at the company also works. Personal mail domains are refused.

Example request

{
  "first_name": "Jane",
  "last_name": "Doe",
  "name": "Dr. Jane Doe",
  "domain": "acme.com"
}

Response

Found or Nothing found

lookup_idstring

Lookup id.

status'valid' | 'catch_all' | 'not_found' | 'no_mail_domain' | 'retry_later'

Outcome.

foundboolean

true when an email came back.

emailstring email nullable

The email.

confirmedboolean

true when the mail server confirmed the address.

confidenceinteger

0 to 100.

credits_chargednumber

Credits charged: 1, 0.25 or 0.

messagestring

The result in one sentence.

Changes

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