Start bulk email find
curl --request POST \
--url https://api.generect.com/api/v1/email/find/bulk/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"leads": [
{
"lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
},
{
"first_name": "Morgan",
"last_name": "Lee",
"domain": "salesforce.com"
}
]
}
'import requests
url = "https://api.generect.com/api/v1/email/find/bulk/"
payload = { "leads": [
{ "lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9" },
{
"first_name": "Morgan",
"last_name": "Lee",
"domain": "salesforce.com"
}
] }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
leads: [
{lead_id: 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'},
{first_name: 'Morgan', last_name: 'Lee', domain: 'salesforce.com'}
]
})
};
fetch('https://api.generect.com/api/v1/email/find/bulk/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.generect.com/api/v1/email/find/bulk/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'leads' => [
[
'lead_id' => 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'
],
[
'first_name' => 'Morgan',
'last_name' => 'Lee',
'domain' => 'salesforce.com'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.generect.com/api/v1/email/find/bulk/"
payload := strings.NewReader("{\n \"leads\": [\n {\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n },\n {\n \"first_name\": \"Morgan\",\n \"last_name\": \"Lee\",\n \"domain\": \"salesforce.com\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.generect.com/api/v1/email/find/bulk/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"leads\": [\n {\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n },\n {\n \"first_name\": \"Morgan\",\n \"last_name\": \"Lee\",\n \"domain\": \"salesforce.com\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/email/find/bulk/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"leads\": [\n {\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n },\n {\n \"first_name\": \"Morgan\",\n \"last_name\": \"Lee\",\n \"domain\": \"salesforce.com\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": null,
"meta": {
"job_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "pending",
"total": 2,
"processed": 0,
"amount_charged": 0,
"error": null
}
}
Email
Start bulk email find
Start an asynchronous bulk email find job. Billed only for valid emails found.
POST
/
api
/
v1
/
email
/
find
/
bulk
/
Start bulk email find
curl --request POST \
--url https://api.generect.com/api/v1/email/find/bulk/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"leads": [
{
"lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
},
{
"first_name": "Morgan",
"last_name": "Lee",
"domain": "salesforce.com"
}
]
}
'import requests
url = "https://api.generect.com/api/v1/email/find/bulk/"
payload = { "leads": [
{ "lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9" },
{
"first_name": "Morgan",
"last_name": "Lee",
"domain": "salesforce.com"
}
] }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
leads: [
{lead_id: 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'},
{first_name: 'Morgan', last_name: 'Lee', domain: 'salesforce.com'}
]
})
};
fetch('https://api.generect.com/api/v1/email/find/bulk/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.generect.com/api/v1/email/find/bulk/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'leads' => [
[
'lead_id' => 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'
],
[
'first_name' => 'Morgan',
'last_name' => 'Lee',
'domain' => 'salesforce.com'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.generect.com/api/v1/email/find/bulk/"
payload := strings.NewReader("{\n \"leads\": [\n {\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n },\n {\n \"first_name\": \"Morgan\",\n \"last_name\": \"Lee\",\n \"domain\": \"salesforce.com\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.generect.com/api/v1/email/find/bulk/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"leads\": [\n {\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n },\n {\n \"first_name\": \"Morgan\",\n \"last_name\": \"Lee\",\n \"domain\": \"salesforce.com\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/email/find/bulk/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"leads\": [\n {\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n },\n {\n \"first_name\": \"Morgan\",\n \"last_name\": \"Lee\",\n \"domain\": \"salesforce.com\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": null,
"meta": {
"job_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "pending",
"total": 2,
"processed": 0,
"amount_charged": 0,
"error": null
}
}
Use Case:
Start an asynchronous bulk job to find verified work emails for many leads (up to 50 per request).Pricing
This is a billable endpoint — you are charged only for each valid email found. If no email is found, the request is free.Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →
Authorizations
Use the required Token prefix. Example: Authorization: Token xxxxxxxxx
Body
application/json
Leads to find emails for (max 50 per request). Each entry is one of: {lead_id}, {linkedin_url}, or {first_name, last_name, domain}.
Maximum array length:
50- By Lead ID
- By LinkedIn URL
- By Name and Domain
Show child attributes
Show child attributes
Was this page helpful?
⌘I