List Deep Research Tasks
List Deep Research tasks.
Overview
This endpoint returns your Deep Research tasks, newest first, with their current statuses and progress counters.Example request
Key parameters
offset(optional): pagination offset.limit(optional): page size; defaults to50.
Success signal
A successful response returns an array of tasks withid, status, brief, depth, progress counters, and the report for finished tasks.
Common errors
401 Unauthorized
Check that your header is Authorization: Bearer ${EXTRUCT_API_TOKEN}.
Related endpoints
Related guides
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
Successful Response
Task lifecycle: created -> in_progress -> done or failed.
created, in_progress, done, failed medium, high, xhigh Research analysis steps completed so far.
Research agents completed so far; billing is one credit per agent.
Unique sources collected across all research agents.
Why the task failed, when status is failed: a rejected brief (with suggestions for fixing it), insufficient credits mid-run, or an internal error. Failed tasks refund their charges.
Markdown report payload, returned when no output_schema was provided.
- DeepResearchMarkdownReport
- DeepResearchSchemaReport