Skip to main content
GET
/
v1
/
deepresearch
/
tasks
/
{id}
/
status
Get task status
curl --request GET \
  --url https://api.valyu.ai/v1/deepresearch/tasks/{id}/status \
  --header 'x-api-key: <api-key>'
{
  "deepresearch_id": "f992a8ab-4c91-4322-905f-190107bd5a5b",
  "status": "running",
  "query": "What are the latest developments in quantum computing?",
  "mode": "lite",
  "output_formats": [
    "markdown"
  ],
  "created_at": 1759617795870,
  "public": false,
  "progress": {
    "current_step": 2,
    "total_steps": 10
  }
}

Authorizations

​
x-api-key
string
header
required

Your Valyu API key. Get one at platform.valyu.ai

Path Parameters

​
id
string<uuid>
required

Deep research task ID (UUID)

Response

Task status retrieved successfully

​
deepresearch_id
string<uuid>

Unique task identifier

​
status
enum<string>

Current task status

Available options:
queued,
running,
completed,
failed,
cancelled
​
query
string

Original research query

​
mode
enum<string>

Research mode used

Available options:
lite,
heavy
​
output_formats
array

Requested output formats

​
created_at
integer

Unix timestamp when task was created

​
public
boolean

Whether the task is publicly accessible

​
progress
object

Progress information (present when running)

​
output_type
enum<string>

Output type (present when completed)

Available options:
markdown,
json
​
output

Research output - markdown string or structured JSON (present when completed)

​
sources
object[]

Sources used in the research (present when completed)

​
usage
object
​
completed_at
integer

Unix timestamp when task completed

​
pdf_url
string<uri>

Pre-signed URL for PDF download (if PDF was requested)

​
images
object[]

Generated images (charts, AI-generated)

​
error
string

Error message (present when failed)