Skip to main content
GET
Get a lead search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required
Example:

"a7d4e2f1-08b3-4c65-9e7a-1b2c3d4e5f60"

Response

id
string<uuid>
required
Example:

"a7d4e2f1-08b3-4c65-9e7a-1b2c3d4e5f60"

query
string
required
Example:

"dental clinics in Berlin"

status
enum<string>
required
Available options:
draft,
queued,
discovering,
processing,
crawling,
enriching,
verifying,
completed,
stopped,
failed
Example:

"processing"

searchMode
enum<string>
required
Available options:
companies,
people
Example:

"companies"

maxResults
number
required
Example:

500

discoveryFinished
boolean
required

Whether the discovery phase has finished (crawl/enrich may still run).

Example:

true

progress
object
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required

When the search row was last updated.

errorMessage
string | null

Failure reason when status is failed; otherwise null.

completedAt
string<date-time> | null

When the search reached a terminal state; null while still running.