Skip to main content
GET
List DeepResearch tasks

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours at platform.valyu.ai.

Query Parameters

limit
integer

Maximum number of tasks to return.

Required range: 1 <= x <= 100

Response

List of DeepResearch tasks.

deepresearch_id
string
required

Unique identifier for the research task.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

query
string
required

The original research query.

Example:

"CRISPR gene therapy clinical trials"

status
enum<string>
required

Current task status.

Available options:
queued,
running,
completed,
failed,
cancelled
Example:

"completed"

created_at
string<date-time>
required

ISO 8601 timestamp of task creation.

Example:

"2024-06-15T10:30:00.000Z"

public
boolean

Whether the task results are publicly accessible.

Example:

false