API Documentation

Integrate email verification into your own applications.

Authentication

All API endpoints require an API key passed in the header.

x-api-key: YOUR_API_KEY

Find & Verify Email

POST /api/find-email

Request Body

{
  "firstName": "John",
  "lastName": "Doe",
  "domainOrCompany": "google.com"
}

Response

{
  "mode": "single",
  "results": [
    {
      "email": "john.doe@google.com",
      "score": 85,
      "confidence": "verified",
      "signals": [
        "smtp_verified",
        "gravatar_found"
      ],
      "method": "smtp"
    }
  ],
  "meta": {
    "domain": "google.com",
    "smtpAvailable": true
  }
}

Verify Single Email

POST /api/verify

Request Body

{
  "email": "john.doe@google.com"
}

Response

{
  "email": "john.doe@google.com",
  "status": "valid",
  "score": 95,
  "provider": "Google Workspace",
  "mx": "smtp.google.com",
  "gravatar": true,
  "disify": {
    "format": true,
    "disposable": false,
    "dns": true
  }
}

Domain Search

POST /api/domain-search

Request Body

{
  "domain": "stripe.com"
}

Response

{
  "domain": "stripe.com",
  "emails": [
    {
      "email": "support@stripe.com",
      "source": "web_scrape"
    },
    {
      "email": "press@stripe.com",
      "source": "web_scrape"
    }
  ],
  "pattern": "first.last"
}