maps-discovery

List maps owner jobs

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

get/maps-discovery/owner-jobs

Request

  • Base URL: https://api.leadsforge.ai
  • URL: https://api.leadsforge.ai/maps-discovery/owner-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": [
    {
      "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.