Skip to main content
GET
Get status
Returns task progress, the current ready_count, and any task-level failure.

Example

Response

Task status can be created, running, done, or error. Finished tasks can return stop_reason values such as limit, source_finished, no_data_timeout, or rejected_streak. See Task results for the recommended polling and fetch loop.

Authorizations

x-api-key
string
header
default:lev8_live_...
required

Query Parameters

leads_search_id
string
required

Response

Task status.

object
string
Allowed value: "entity_search_status"
leads_search_id
string
Example:

"leads_search_01JABCDEF123456789"

meta
object
status
object
error
object | null
created_at
string<date-time>
Example:

"2026-08-04T00:00:00Z"

updated_at
string<date-time>
Example:

"2026-08-04T00:00:08Z"