Batches

List tasks in a batch

Retrieve tasks within a batch with optional status filtering and cursor-based pagination. Use include_output=true to get full output, sources, images, and cost for each task. When include_output is false (default), returns a lightweight listing with status only.

get/v1/deepresearch/batches/{id}/tasks

Request

  • Base URL: https://api.valyu.ai
  • URL: https://api.valyu.ai/v1/deepresearch/batches/{id}/tasks
  • Auth: API key in header X-API-Key

Path parameters

idstring required

Batch ID.

Query parameters

status'queued' | 'running' | 'completed' | 'failed' | 'cancelled'

Filter tasks by status.

limitinteger

Maximum number of tasks to return.

last_keystring nullable

Pagination cursor. Omit on first request. Pass the last_key value from a previous response to fetch the next page.

include_outputboolean

Include full output, sources, images, and cost for each task. When false (default), returns lightweight task listing with status only.

Response

Paginated list of batch tasks.

batch_idstring required

ID of the batch these tasks belong to.

Example response

{
  "batch_id": "batch_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "tasks": [
    {
      "deepresearch_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "completed",
      "query": "Analyze Tesla Q4 2024 earnings",
      "created_at": "2024-06-15T10:30:00.000Z",
      "output": "## Tesla Q4 2025 Earnings Analysis\n\n...",
      "pdf_url": "https://api.valyu.ai/v1/deepresearch/tasks/52fafd51/pdf",
      "error": "Task exceeded maximum execution time",
      "cost": 1
    }
  ],
  "pagination": {
    "count": 10
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.