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
id (required): The LeadList id returned from the execute endpoint.
Responses
200: Complete: download_url ready
404: Unknown or cross-account lead list ID