Skip to main content
GET
Get maps owner job

Authorizations

Authorization
string
header
required

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

Path Parameters

jobID
string
required

Job ID

Response

Job status

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"