Get the status of asynchronous search task

Check a task submitted via /v2/search/submit or /v2/search with async=true. Use its task_id (equal to uuid), not thread_id. For newly started background tasks (HTTP 202), this endpoint can recover results when a callback is missed. Cached calls (HTTP 200) return results directly; polling their new task ID can return completed with result=null. Its outer status="completed" and the nested result's legacy status="Done" both indicate success.

The task status can be one of:

  • pending: Task is queued but not yet started
  • completed: Task has finished successfully; see the cached-result caveat above
  • failed: Task failed and error details are provided

Cost: 0 credits

Check out official Python client

Path Params
string
required

The task_id (equal to uuid) returned by /v2/search/submit or an asynchronous /v2/search call.

Responses

401

Invalid API key

404

Task not found

500

Database error

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json