Find phone
curl --request POST \
--url https://api.generect.com/api/v1/phone/find/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
}
'import requests
url = "https://api.generect.com/api/v1/phone/find/"
payload = { "lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9" }
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({lead_id: 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'})
};
fetch('https://api.generect.com/api/v1/phone/find/', 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/",
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([
'lead_id' => 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'
]),
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/"
payload := strings.NewReader("{\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\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/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/phone/find/")
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 \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"phone": {
"number": "+14155550123",
"status": "FOUND",
"type": "mobile",
"country": "US"
}
},
"meta": {
"amount_charged": 0.4
}
}Phone
Find phone
Find a phone number by lead ID, LinkedIn URL, or by name and company. Billed only when a phone number is found.
POST
/
api
/
v1
/
phone
/
find
/
Find phone
curl --request POST \
--url https://api.generect.com/api/v1/phone/find/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
}
'import requests
url = "https://api.generect.com/api/v1/phone/find/"
payload = { "lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9" }
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({lead_id: 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'})
};
fetch('https://api.generect.com/api/v1/phone/find/', 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/",
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([
'lead_id' => 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'
]),
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/"
payload := strings.NewReader("{\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\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/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/phone/find/")
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 \"lead_id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"lead_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"phone": {
"number": "+14155550123",
"status": "FOUND",
"type": "mobile",
"country": "US"
}
},
"meta": {
"amount_charged": 0.4
}
}Use Case:
Find a phone number bylead_id, linkedin_url, or by first_name + last_name + company.
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
Use the required Token prefix. Example: Authorization: Token xxxxxxxxx
Body
application/json
- By Lead ID
- By LinkedIn URL
- By Name and Company
Generect lead identifier from Search, Preview, or Enrich.
Example:
"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
Was this page helpful?
⌘I