maps-discovery

Get maps search job status

Fetch the status of a local business search job.

get/maps-discovery/jobs/{jobID}

Request

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

Path parameters

jobIDstring required

Job ID

Response

Job status

categoriesstring[]

clientRequestIDstring

completedAtstring

consumedCreditsnumber

createdAtstring

errorstring

foundCountinteger

jobIDstring

languagestring

latnumber

limitinteger

lngnumber

radiusKmnumber

reservedCreditsnumber

resultsURLstring

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

statusURLstring

updatedAtstring

webhookURLstring

Example response

{
  "categories": [
    "Dentist",
    "Dental Clinic"
  ],
  "clientRequestID": "req_12345",
  "completedAt": "2026-09-13T12:05:00Z",
  "consumedCredits": 143,
  "createdAt": "2026-09-13T12:00:00Z",
  "foundCount": 143,
  "jobID": "5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60",
  "language": "en",
  "lat": 40.758,
  "limit": 200,
  "lng": -73.9855,
  "radiusKm": 5,
  "reservedCredits": 200,
  "resultsURL": "/public/v1/maps-discovery/jobs/5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60/results",
  "status": "in_progress",
  "statusURL": "/public/v1/maps-discovery/jobs/5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60",
  "updatedAt": "2026-09-13T12:01:00Z",
  "webhookURL": "https://example.com/webhooks/maps-search"
}

Changes

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