Email

Find a person’s work email from a company domain or name, list the emails on a company’s site, and check whether an address can receive mail. See every field in the Email reference, or try it in the playground.

Find a person’s work email from their name, or the emails on a company’s site

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.email.find({ name: "Patrick Collison", domain: "stripe.com" });
console.log(result.data);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.email.find(name="Patrick Collison", domain="stripe.com")
print(result["data"])

curl -X POST https://api.stophy.dev/v1/email/find \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"name":"Patrick Collison","domain":"stripe.com"}'

stophy email find stripe.com --name "Patrick Collison"

The response:

{
  "success": true,
  "data": {
    "email": "patrick@stripe.com",
    "status": "valid",
    "domain": "stripe.com",
    "mxProvider": "google.com"
  },
  "creditsUsed": 1,
  "requestId": "7ee48ae7-9f8f-4d3a-ab08-f2ba90fa13ae"
}

Endpoints

Endpoint	Cost
Find a person’s work email from their name, or the emails on a company’s site	1 credit
Check if an email address can receive mail	1 credit

More ways to call it

Check if an email address can receive mail

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.email.verify({ email: "info@the305agency.com" });
console.log(result.data);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.email.verify(email="info@the305agency.com")
print(result["data"])

curl -X POST https://api.stophy.dev/v1/email/verify \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"email":"info@the305agency.com"}'

stophy email verify info@the305agency.com

The response. status is valid, risky or invalid.

{
  "success": true,
  "data": {
    "email": "info@the305agency.com",
    "status": "valid",
    "mxProvider": "google.com",
    "isRole": true,
    "isDisposable": false,
    "isFree": false
  },
  "creditsUsed": 1,
  "requestId": "552f1480-c351-4bb8-a417-48aaa08e94c8"
}

Emails on a company’s site

Leave out the name to get the emails found on the company’s site, each one checked. type is personal or generic.

cURL

curl -X POST https://api.stophy.dev/v1/email/find \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"domain":"the305agency.com"}'

The response:

{
  "success": true,
  "data": {
    "domain": "the305agency.com",
    "mxProvider": "google.com",
    "results": [
      {
        "email": "info@the305agency.com",
        "status": "valid",
        "type": "generic"
      },
      {
        "email": "info@sandra305.com",
        "status": "valid",
        "type": "generic"
      }
    ]
  },
  "creditsUsed": 1,
  "requestId": "d01438d1-ab71-480e-9ea7-c3e29ea29c9e"
}

You pay 1 credit only when a valid email comes back. Risky, not found and failed calls cost nothing. A role address like info@ is judged by its mail server, and isRole flags it.

Get started

What you can get

Guides

Plans and billing

Find a person’s work email from their name, or the emails on a company’s site

Endpoints

More ways to call it

Check if an email address can receive mail

Emails on a company’s site

​Find a person’s work email from their name, or the emails on a company’s site

​Endpoints

​More ways to call it

​Check if an email address can receive mail

​Emails on a company’s site

Find a person’s work email from their name, or the emails on a company’s site

Endpoints

More ways to call it

Check if an email address can receive mail

Emails on a company’s site