Skip to main content
GET
Returns the current status and progress of a lead database search.

Request

string
required
Your API key

Path Parameters

string
required
The search ID returned from the create search endpoint

Response

string
Unique identifier for the search
string
Name of the search
string
Current status: pending, processing, completed, failed
object
string
ISO 8601 timestamp when the search was created

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

id
string
required

Search ID

Response

Search status

id
string
required

Unique identifier for the search

name
string
required

Name of the search

status
enum<string>
required

Current status of the search

Available options:
pending,
processing,
completed,
failed
created_at
string<date-time>
required

ISO 8601 timestamp when the search was created

totalResults
integer

Total number of leads found (available when completed)

progress
integer

Progress percentage (0-100)

completed_at
string<date-time>

ISO 8601 timestamp when the search completed