Skip to main content
GET
/
v1
/
deepresearch
/
list
List DeepResearch tasks
curl --request GET \
  --url https://api.valyu.ai/v1/deepresearch/list \
  --header 'X-API-Key: <api-key>'
[
  {
    "deepresearch_id": "f992a8ab-4c91-4322-905f-190107bd5a5b",
    "query": "CRISPR gene therapy clinical trials",
    "status": "completed",
    "created_at": "2024-06-15T10:30:00.000Z",
    "public": false
  },
  {
    "deepresearch_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "query": "Quantum computing market analysis",
    "status": "running",
    "created_at": "2024-06-15T11:00:00.000Z",
    "public": false
  }
]

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