Skip to main content
Find email address for a lead.

​
Endpoint

POST https://api.sixtyfour.ai/find-email

​
Request

​
Headers

NameTypeRequiredDescription
x-api-keystringYesYour Sixtyfour API key
Content-TypestringYesMust be application/json

​
Body

FieldTypeRequiredDescription
leadobjectYesLead information to find email for
modestringNoEmail discovery mode. Allowed values: "PROFESSIONAL" (default) for company emails, "PERSONAL" for personal emails.

​
Example Request (PROFESSIONAL mode)

{
  "lead": {
    "name": "Sarah Chen",
    "company": "Pacific View Studios",
    "title": "Creative Director & Lead Photographer",
    "phone": "+16195551234",
    "linkedin": "https://www.linkedin.com/in/sarah-chen-photography"
  },
  "mode": "PROFESSIONAL"
}

​
Example Request (PERSONAL mode)

{
  "lead": {
    "name": "Sarah Chen",
    "company": "Pacific View Studios",
    "title": "Creative Director & Lead Photographer",
    "phone": "+16195551234",
    "linkedin": "https://www.linkedin.com/in/sarah-chen-photography"
  },
  "mode": "PERSONAL"
}

​
Response

​
Success Response (200)

Returns found email addresses with validation status. The response fields differ by mode:
  • In PROFESSIONAL mode: company emails are returned in the email field.
  • In PERSONAL mode: personal emails are returned in personal_email, and company emails (if any) are returned in email.
Example (PROFESSIONAL mode): 
{
  "name": "Sarah Chen",
  "company": "Pacific View Studios",
  "title": "Creative Director & Lead Photographer",
  "phone": "+16195551234",
  "linkedin": "https://www.linkedin.com/in/sarah-chen-photography",
  "email": [["[email protected]", "OK", "COMPANY"]]
}
Example (PERSONAL mode): 
{
  "name": "Sarah Chen",
  "company": "Pacific View Studios",
  "title": "Creative Director & Lead Photographer",
  "phone": "+16195551234",
  "linkedin": "https://www.linkedin.com/in/sarah-chen-photography",
  "personal_email": [["[email protected]", "OK", "PERSONAL"]],
  "email": [["[email protected]", "OK", "COMPANY"]]
}
The email field contains a list of tuples, where each tuple consists of:
  • Email address (string)
  • Validation status (string):
    • "OK": The email address has been validated and is likely deliverable
    • "UNKNOWN": The email address could not be validated or its deliverability status is uncertain, most likely because of catch all domains.
  • Email type (string):
    • "COMPANY": The email address is associated with the company domain
    • "PERSONAL": The email address is a personal email address (e.g., Gmail, Yahoo, etc.)
If the lead information already includes an email field, it will be returned unchanged in the response with appropriate status and type. In PERSONAL mode, if the existing email is a personal email, the API returns immediately without additional processing or cost.

​
Pricing

  • PROFESSIONAL mode (company emails): $0.05 per request
  • PERSONAL mode (personal emails): $0.20 per request

​
Error Response (400)

{
  "error": "Bad Request",
  "message": "Invalid lead data"
}

​
Rate Limits

The API is rate limited to 1000 requests per minute per API key.

​
Example Usage

import requests

response = requests.post(
    'https://api.sixtyfour.ai/find-email',
    headers={
        'x-api-key': 'your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        "lead": {
            "name": "Sarah Chen",
            "company": "Pacific View Studios",
            "title": "Creative Director & Lead Photographer",
            "phone": "+16195551234",
            "linkedin": "https://www.linkedin.com/in/sarah-chen-photography"
        },
        "mode": "PERSONAL"
    }
)

results = response.json()