Start bulk phone find
curl --request POST \
--url https://api.generect.com/api/v1/phone/find/bulk/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"leads": [
{
"lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
},
{
"first_name": "Jordan",
"last_name": "Ellis",
"company": "microsoft.com"
}
]
}
'import requests
url = "https://api.generect.com/api/v1/phone/find/bulk/"
payload = { "leads": [
{ "lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9" },
{
"first_name": "Jordan",
"last_name": "Ellis",
"company": "microsoft.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: 'Jordan', last_name: 'Ellis', company: 'microsoft.com'}
]
})
};
fetch('https://api.generect.com/api/v1/phone/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/phone/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' => 'Jordan',
'last_name' => 'Ellis',
'company' => 'microsoft.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/phone/find/bulk/"
payload := strings.NewReader("{\n \"leads\": [\n {\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n },\n {\n \"first_name\": \"Jordan\",\n \"last_name\": \"Ellis\",\n \"company\": \"microsoft.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/phone/find/bulk/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"leads\": [\n {\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n },\n {\n \"first_name\": \"Jordan\",\n \"last_name\": \"Ellis\",\n \"company\": \"microsoft.com\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/phone/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\": \"Jordan\",\n \"last_name\": \"Ellis\",\n \"company\": \"microsoft.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
}
}{
"status": "error",
"status_code": 400,
"detail": {
"leads": [
"This field is required."
]
}
}{
"status": "error",
"status_code": 401,
"detail": "Authentication credentials were not provided."
}{
"status": "error",
"status_code": 402,
"detail": "Insufficient funds in the account."
}{
"status": "error",
"status_code": 403,
"detail": "You do not have permission to perform this action."
}Phone
Start bulk phone find
Start an asynchronous bulk phone finder job. Billed only for phone numbers found.
POST
/
api
/
v1
/
phone
/
find
/
bulk
/
Start bulk phone find
curl --request POST \
--url https://api.generect.com/api/v1/phone/find/bulk/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"leads": [
{
"lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
},
{
"first_name": "Jordan",
"last_name": "Ellis",
"company": "microsoft.com"
}
]
}
'import requests
url = "https://api.generect.com/api/v1/phone/find/bulk/"
payload = { "leads": [
{ "lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9" },
{
"first_name": "Jordan",
"last_name": "Ellis",
"company": "microsoft.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: 'Jordan', last_name: 'Ellis', company: 'microsoft.com'}
]
})
};
fetch('https://api.generect.com/api/v1/phone/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/phone/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' => 'Jordan',
'last_name' => 'Ellis',
'company' => 'microsoft.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/phone/find/bulk/"
payload := strings.NewReader("{\n \"leads\": [\n {\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n },\n {\n \"first_name\": \"Jordan\",\n \"last_name\": \"Ellis\",\n \"company\": \"microsoft.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/phone/find/bulk/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"leads\": [\n {\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n },\n {\n \"first_name\": \"Jordan\",\n \"last_name\": \"Ellis\",\n \"company\": \"microsoft.com\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/phone/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\": \"Jordan\",\n \"last_name\": \"Ellis\",\n \"company\": \"microsoft.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
}
}{
"status": "error",
"status_code": 400,
"detail": {
"leads": [
"This field is required."
]
}
}{
"status": "error",
"status_code": 401,
"detail": "Authentication credentials were not provided."
}{
"status": "error",
"status_code": 402,
"detail": "Insufficient funds in the account."
}{
"status": "error",
"status_code": 403,
"detail": "You do not have permission to perform this action."
}Use Case:
Start an asynchronous bulk phone finder job (up to 50 leads per request).Pricing
This is a billable endpoint — you are charged only for each phone number found. If no phone is found, the request is free.Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →
Authorizations
Body
application/json
List of leads to find phones for (max 50 per request). Each entry is either a lead_id, linkedin_url, or name+company.
Maximum array length:
50- By Lead ID
- By LinkedIn URL
- By Name and Company
Show child attributes
Show child attributes
Was this page helpful?