Log in Get an API key

API Reference › Property Search

Get Lead List Status

GET /v1/api/property-search/{id}/

Cost: Free.

Rate limit: No limit.

Mode: Sync

Poll a lead list for completion status. Returns the current stage, progress percent, and the CSV download_url once the build finishes. Stages: fetching_properties → skip_tracing → generating_csv → *(empty when complete)*. Ownership is enforced: you can only poll lead lists your account created. Unknown IDs return 404 (same as cross-user access attempts, to prevent ID enumeration). Polling cadence: poll every 2-5 seconds and back off as the stage advances, or skip polling entirely by configuring your account webhook. The CSV: download_url is a time-limited signed URL (valid ~1 hour). Related endpoints: Get Lead List Rows · Property Lookup · Address Autocomplete

Fields

Responses