Skip to main content
GET
Get search status
Requires leads:read. Use the id returned by search creation. States are pending, processing, completed, and failed. Poll with a delay rather than a tight loop. Completion does not guarantee the requested number of matches; inspect progress and actual results. Preserve the job ID for support or recovery instead of recreating the paid search.

Authorizations

X-API-Key
string
header
required

API key for authentication (prefix: sp_live_ or sp_test_)

Path Parameters

id
string
required

Search ID

Response

id
string
required
name
string
required
status
enum<string>
required
Available options:
pending,
processing,
completed,
failed
progress
object
required
created_at
string
required
completed_at
string
error_message
string