curl --request POST \
--url https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"businessIDs": [
"3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
],
"maxResults": 3,
"searchJobID": "5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60",
"clientRequestID": "req_12345",
"wantEmail": true,
"wantPhone": true,
"webhookURL": "https://example.com/webhooks/maps-owners"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
businessIDs: ['3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d'],
maxResults: 3,
searchJobID: '5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60',
clientRequestID: 'req_12345',
wantEmail: true,
wantPhone: true,
webhookURL: 'https://example.com/webhooks/maps-owners'
})
};
fetch('https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
businessIDs: ['3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d'],
maxResults: 3,
searchJobID: '5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60',
clientRequestID: 'req_12345',
wantEmail: true,
wantPhone: true,
webhookURL: 'https://example.com/webhooks/maps-owners'
})
};
fetch('https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners';
const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
businessIDs: ['3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d'],
maxResults: 3,
searchJobID: '5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60',
clientRequestID: 'req_12345',
wantEmail: true,
wantPhone: true,
webhookURL: 'https://example.com/webhooks/maps-owners'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners"
payload = {
"businessIDs": ["3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"],
"maxResults": 3,
"searchJobID": "5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60",
"clientRequestID": "req_12345",
"wantEmail": True,
"wantPhone": True,
"webhookURL": "https://example.com/webhooks/maps-owners"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners"
payload := strings.NewReader("{\n \"businessIDs\": [\n \"3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\"\n ],\n \"maxResults\": 3,\n \"searchJobID\": \"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60\",\n \"clientRequestID\": \"req_12345\",\n \"wantEmail\": true,\n \"wantPhone\": true,\n \"webhookURL\": \"https://example.com/webhooks/maps-owners\"\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.leadsforge.ai/public/v1/maps-discovery/enrich-owners")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"businessIDs\": [\n \"3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\"\n ],\n \"maxResults\": 3,\n \"searchJobID\": \"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60\",\n \"clientRequestID\": \"req_12345\",\n \"wantEmail\": true,\n \"wantPhone\": true,\n \"webhookURL\": \"https://example.com/webhooks/maps-owners\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
request.AddJsonBody("{\n \"businessIDs\": [\n \"3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\"\n ],\n \"maxResults\": 3,\n \"searchJobID\": \"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60\",\n \"clientRequestID\": \"req_12345\",\n \"wantEmail\": true,\n \"wantPhone\": true,\n \"webhookURL\": \"https://example.com/webhooks/maps-owners\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners",
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([
'businessIDs' => [
'3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d'
],
'maxResults' => 3,
'searchJobID' => '5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60',
'clientRequestID' => 'req_12345',
'wantEmail' => true,
'wantPhone' => true,
'webhookURL' => 'https://example.com/webhooks/maps-owners'
]),
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;
}require 'uri'
require 'net/http'
url = URI("https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners")
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 \"businessIDs\": [\n \"3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\"\n ],\n \"maxResults\": 3,\n \"searchJobID\": \"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60\",\n \"clientRequestID\": \"req_12345\",\n \"wantEmail\": true,\n \"wantPhone\": true,\n \"webhookURL\": \"https://example.com/webhooks/maps-owners\"\n}"
response = http.request(request)
puts response.read_body{
"accepted": 48,
"businesses": [
{
"businessID": "3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"reason": "business not found in this list",
"status": "skipped"
}
],
"clientRequestID": "req_12345",
"completedAt": "<string>",
"consumedCredits": 123,
"createdAt": "2026-09-13T12:10:00Z",
"error": "<string>",
"jobID": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"maxResults": 3,
"ownersFound": 0,
"processed": 12,
"reservedCredits": 123,
"resultsURL": "/public/v1/maps-discovery/owner-jobs/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/results",
"searchJobID": "5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60",
"status": "in_progress",
"statusURL": "/public/v1/maps-discovery/owner-jobs/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"total": 50,
"updatedAt": "2026-09-13T12:11:00Z",
"wantEmail": true,
"wantPhone": true,
"webhookURL": "https://example.com/webhooks/maps-owners"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}Enrich owners of local businesses
Asynchronous. Starts an owner search for up to 200 businesses of one search job (searchJobID, businessIDs), looking for up to maxResults owners per business and the requested contact channels (wantEmail and/or wantPhone), and returns 202 with the job; poll GET /maps-discovery/owner-jobs/ or pass webhookURL, then page through GET /maps-discovery/owner-jobs//results.
Consumes credits: your account’s maps owner email and phone prices per contact found. The job holds credits only for businesses that need a new owner search: maxResults x the price of each requested channel, per business, and settles per contact found; a business with no owner costs nothing. Owners already found recently for the same place in your account, by this search or an earlier one, are reused without a new owner search and hold nothing, but their missing email/phone is still looked up and charged at the same prices, so consumedCredits can exceed reservedCredits.
Only one owner job per search runs at a time; a second one while the first is in progress is refused with 409. Each business in the businesses list gets a status: queued; cached (owners already found are reused); skipped (not part of this search job, or could not be processed; see reason); already_enriching (its ID appears more than once in the request). If none is accepted the job ends as no_results.
Supports the Idempotency-Key header and webhookURL as POST /maps-discovery/search does. Webhook payload: jobID (string), status (completed|failed|no_results), searchJobID (string), total (int), processed (int), ownersFound (int), consumedCredits (number), error (string; present on failed and no_results jobs, and on completed jobs that stopped looking up contacts early because credits ran out).
curl --request POST \
--url https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"businessIDs": [
"3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
],
"maxResults": 3,
"searchJobID": "5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60",
"clientRequestID": "req_12345",
"wantEmail": true,
"wantPhone": true,
"webhookURL": "https://example.com/webhooks/maps-owners"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
businessIDs: ['3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d'],
maxResults: 3,
searchJobID: '5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60',
clientRequestID: 'req_12345',
wantEmail: true,
wantPhone: true,
webhookURL: 'https://example.com/webhooks/maps-owners'
})
};
fetch('https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
businessIDs: ['3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d'],
maxResults: 3,
searchJobID: '5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60',
clientRequestID: 'req_12345',
wantEmail: true,
wantPhone: true,
webhookURL: 'https://example.com/webhooks/maps-owners'
})
};
fetch('https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners';
const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
businessIDs: ['3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d'],
maxResults: 3,
searchJobID: '5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60',
clientRequestID: 'req_12345',
wantEmail: true,
wantPhone: true,
webhookURL: 'https://example.com/webhooks/maps-owners'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners"
payload = {
"businessIDs": ["3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"],
"maxResults": 3,
"searchJobID": "5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60",
"clientRequestID": "req_12345",
"wantEmail": True,
"wantPhone": True,
"webhookURL": "https://example.com/webhooks/maps-owners"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners"
payload := strings.NewReader("{\n \"businessIDs\": [\n \"3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\"\n ],\n \"maxResults\": 3,\n \"searchJobID\": \"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60\",\n \"clientRequestID\": \"req_12345\",\n \"wantEmail\": true,\n \"wantPhone\": true,\n \"webhookURL\": \"https://example.com/webhooks/maps-owners\"\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.leadsforge.ai/public/v1/maps-discovery/enrich-owners")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"businessIDs\": [\n \"3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\"\n ],\n \"maxResults\": 3,\n \"searchJobID\": \"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60\",\n \"clientRequestID\": \"req_12345\",\n \"wantEmail\": true,\n \"wantPhone\": true,\n \"webhookURL\": \"https://example.com/webhooks/maps-owners\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
request.AddJsonBody("{\n \"businessIDs\": [\n \"3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\"\n ],\n \"maxResults\": 3,\n \"searchJobID\": \"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60\",\n \"clientRequestID\": \"req_12345\",\n \"wantEmail\": true,\n \"wantPhone\": true,\n \"webhookURL\": \"https://example.com/webhooks/maps-owners\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners",
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([
'businessIDs' => [
'3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d'
],
'maxResults' => 3,
'searchJobID' => '5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60',
'clientRequestID' => 'req_12345',
'wantEmail' => true,
'wantPhone' => true,
'webhookURL' => 'https://example.com/webhooks/maps-owners'
]),
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;
}require 'uri'
require 'net/http'
url = URI("https://api.leadsforge.ai/public/v1/maps-discovery/enrich-owners")
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 \"businessIDs\": [\n \"3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\"\n ],\n \"maxResults\": 3,\n \"searchJobID\": \"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60\",\n \"clientRequestID\": \"req_12345\",\n \"wantEmail\": true,\n \"wantPhone\": true,\n \"webhookURL\": \"https://example.com/webhooks/maps-owners\"\n}"
response = http.request(request)
puts response.read_body{
"accepted": 48,
"businesses": [
{
"businessID": "3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"reason": "business not found in this list",
"status": "skipped"
}
],
"clientRequestID": "req_12345",
"completedAt": "<string>",
"consumedCredits": 123,
"createdAt": "2026-09-13T12:10:00Z",
"error": "<string>",
"jobID": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"maxResults": 3,
"ownersFound": 0,
"processed": 12,
"reservedCredits": 123,
"resultsURL": "/public/v1/maps-discovery/owner-jobs/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/results",
"searchJobID": "5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60",
"status": "in_progress",
"statusURL": "/public/v1/maps-discovery/owner-jobs/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"total": 50,
"updatedAt": "2026-09-13T12:11:00Z",
"wantEmail": true,
"wantPhone": true,
"webhookURL": "https://example.com/webhooks/maps-owners"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}{
"code": "<string>",
"data": "<unknown>",
"message": "<string>"
}Authorizations
Headers
Body
Owner enrichment request
Owner enrichment request
Response
Job created
Processed is the number of accepted businesses whose owner search has finished; it never exceeds accepted. It is live on GET /maps-discovery/owner-jobs/{jobID}; in GET /maps-discovery/owner-jobs it stays 0 until the job ends. Use status, not processed, to tell when the job is done.
12
Was this page helpful?
