maps-discovery

Get maps owner job status

Fetch the status of an owner enrichment job. While in progress, processed counts the businesses whose owner search has finished.

get/maps-discovery/owner-jobs/{jobID}

Request

Base URL: https://api.leadsforge.ai
URL: https://api.leadsforge.ai/maps-discovery/owner-jobs/{jobID}
Auth: ApiKeyAuth (a scheme the document does not define)

Path parameters

jobIDstring required

Job ID

Response

Job status

acceptedinteger

clientRequestIDstring

completedAtstring

consumedCreditsnumber

createdAtstring

errorstring

set on failed jobs, and on completed jobs whose email/phone backfill stopped early for insufficient credits

jobIDstring

maxResultsinteger

ownersFoundinteger

processedinteger

reservedCreditsnumber

resultsURLstring

searchJobIDstring

status'in_progress' | 'completed' | 'failed' | 'no_results'

statusURLstring

totalinteger

updatedAtstring

wantEmailboolean

wantPhoneboolean

webhookURLstring

Example response

{
  "accepted": 48,
  "businesses": [
    {
      "businessID": "3c1a2b4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "reason": "business not found or not owned by account",
      "status": "queued"
    }
  ],
  "clientRequestID": "req_12345",
  "completedAt": "2026-09-13T12:25:00Z",
  "createdAt": "2026-09-13T12:10:00Z",
  "jobID": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "maxResults": 3,
  "processed": 12,
  "reservedCredits": 2880,
  "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"
}

Changes

No recorded changes to this operation across all 1 revision of this API.