maps-discovery

List maps search jobs

List the caller's local business search jobs, most recent first. Use the filters (status, clientRequestID, from/to) to recover a job when the job ID is unknown.

get/maps-discovery/jobs

Request

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

Query parameters

offsetinteger

Offset

limitinteger required

Page size (max 100)

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

Filter by status

clientRequestIDstring

Filter by your clientRequestID

fromstring

Created-at lower bound (RFC3339)

tostring

Created-at upper bound (RFC3339)

Response

Jobs

limitinteger
offsetinteger
totalinteger

Example response

{
  "jobs": [
    {
      "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.