Email Finder

Find email address of an individual using their name and company domain.

Curl

cURL 'https://api.enrich.so/v1/api/find-email?fullName=<FirstName LastName>&companyDomain=<example.com>'
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json'

Javascript

const axios = require('axios');

axios.get('https://api.enrich.so/v1/api/find-email?fullName=<FirstName LastName>&companyDomain=<example.com>', {
    headers: {accept: 'application/json', Authorization: 'Bearer <token>'}
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.log(error);
  });

Java

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.enrich.so/v1/api/find-email?fullName=<FirstName LastName>&companyDomain=<example.com>")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer <token>")
  .build();

Response response = client.newCall(request).execute();

Python

import requests
payload = {'fullName':'<FirstName LastName>', 'companyDomain':'<example.com>' }
headers = {'accept': 'application/json', 'authorization': 'Bearer <token>'}
resp = requests.get('https://api.enrich.so/v1/api/find-email', params=payload, headers=headers)
print (resp.text)

Php

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enrich.so/v1/api/find-email?fullName=<FirstName LastName>&companyDomain=<example.com>",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Ruby

require 'uri'
require 'net/http'

url = URI("https://api.enrich.so/v1/api/find-email?fullName=<FirstName LastName>&companyDomain=<example.com>")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
request["authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

The Email Finder API is an asynchronous endpoint that may return a status code 202, indicating that the request has been accepted and the client should retry the same payload after a short delay, as specified in the response message.

Example response

Status Code: 202 ACCEPTED

{
    "status": "in_progress",
    "message": "Request queued. Retry again after a few seconds with the same parameters"
}

Status Code: 200 OK

{
    "email": "[e-mail]",
    "firstName": "username",
    "lastName": "lastname",
    "domain": "example.com",
    "acceptAll": true,
    "found": true,
    "total_credits": 25000,
    "credits_used": 229,
    "credits_remaining": 24771
}

Status code: 404 NOT FOUND

{
    "error": true,
    "message": "No email found"
}