Skip to main content
POST
Enrich owners of local businesses

Authorizations

Authorization
string
header
required

Your API key, sent as is (no Bearer prefix). Create it in the Leadsforge app under Settings -> API & MCP.

Headers

Idempotency-Key
string

Idempotency key - if a job with this key already exists in your account, the existing job is returned as is

Body

application/json

Owner enrichment request

Owner enrichment request

businessIDs
string<uuid>[]
required
Required array length: 1 - 200 elements
Example:
maxResults
integer
required

MaxResults is the number of owners to look for per business.

Required range: 1 <= x <= 8
Example:

3

searchJobID
string
required
Example:

"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60"

clientRequestID
string
Maximum string length: 128
Example:

"req_12345"

wantEmail
boolean

WantEmail asks for owner emails. Set at least one of wantEmail and wantPhone, or the request fails with 400.

Example:

true

wantPhone
boolean

WantPhone asks for owner phone numbers. Set at least one of wantEmail and wantPhone, or the request fails with 400.

Example:

true

webhookURL
string
Example:

"https://example.com/webhooks/maps-owners"

Response

Job created

accepted
integer

Accepted is the number of businesses that got an owner search: queued plus cached.

Example:

48

businesses
object[]
clientRequestID
string
Example:

"req_12345"

completedAt
string
consumedCredits
number
createdAt
string
Example:

"2026-09-13T12:10:00Z"

error
string

Error is set on failed and no_results jobs, and on completed jobs that stopped looking up contacts early because credits ran out.

jobID
string
Example:

"9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"

maxResults
integer
Example:

3

ownersFound
integer
Example:

0

processed
integer

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.

Example:

12

reservedCredits
number
resultsURL
string
Example:

"/public/v1/maps-discovery/owner-jobs/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/results"

searchJobID
string
Example:

"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60"

status
enum<string>
Available options:
in_progress,
completed,
failed,
no_results
Example:

"in_progress"

statusURL
string
Example:

"/public/v1/maps-discovery/owner-jobs/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"

total
integer

Total is the number of business IDs in the request, duplicates included.

Example:

50

updatedAt
string
Example:

"2026-09-13T12:11:00Z"

wantEmail
boolean
Example:

true

wantPhone
boolean
Example:

true

webhookURL
string
Example:

"https://example.com/webhooks/maps-owners"