One call, one confirmed address.

The API uses the same credits as the website, and a credit is used only when an address is found. Make a key in your account.

Find an address

curl https://findy.email/api/v1/find \
  -H "Authorization: Bearer fnd_your_key" \
  -H "Content-Type: application/json" \
  -d '{"first":"Jane","last":"Doe","domain":"acme.com"}'

The call waits for the answer, usually a few seconds. A person we cannot find can take about a minute, so set your timeout to 90 seconds.

When we find it

{ "found": true, "email": "[email protected]", "confidence": "high", "credits": 999 }

When we do not

{ "found": false, "reason": "none", "message": "We could not confirm an address for this person. You were not charged.", "credits": 999 }

Reasons for no result

Errors