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": "standard",
  "output_formats": [
    "markdown"
  ],
  "created_at": "2025-01-15T10:30:00.000Z",
  "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:
fast,
standard,
heavy
​
output_formats
array

Requested output formats

​
created_at
string<date-time>

ISO 8601 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,
toon
​
output

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

​
sources
object[]

Sources used in the research (present when completed)

​
cost
number<float>

Fixed cost for the research task based on mode: $0.10 (fast), $0.50 (standard), $1.50 (heavy)

​
completed_at
string<date-time>

ISO 8601 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)

​
deliverables
object[]

Generated deliverable files (CSV, Excel, PowerPoint, Word, PDF)

​
error
string

Error message (present when failed)

​
batch_id
string<uuid>

Batch ID if task belongs to a batch

​
batch_task_id
string

Batch task identifier if task belongs to a batch