Batches

Get batch status

Retrieve the current status, task counts, and aggregated cost of a batch.

get/v1/deepresearch/batches/{id}

Request

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

Path parameters

idstring required

Batch ID.

Response

Batch status.

batch_idstring required

Unique batch identifier.

status'open' | 'processing' | 'completed' | 'completed_with_errors' | 'cancelled' required

Batch lifecycle status.

  • open - Batch created, accepting tasks
  • processing - Tasks are running
  • completed - All tasks finished successfully
  • completed_with_errors - All tasks finished, some failed
  • cancelled - Batch was cancelled
mode'fast' | 'standard' | 'heavy' | 'max' required

Research mode for all tasks in this batch.

created_atstring date-time required

ISO 8601 timestamp of batch creation.

namestring

Human-readable name for the batch.

search_paramsobject

Shared search configuration.

costnumber required

Aggregated cost in USD across all tasks.

completed_atstring date-time

ISO 8601 timestamp. Present when batch is completed.

webhook_secretstring

HMAC-SHA256 secret. Only present on creation when webhook_url was provided.

Example response

{
  "batch_id": "batch_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing",
  "mode": "standard",
  "created_at": "2024-06-15T10:30:00.000Z",
  "name": "Q4 Earnings Analysis Batch",
  "output_formats": [
    "markdown"
  ],
  "counts": {
    "total": 10,
    "queued": 3,
    "running": 2,
    "completed": 4,
    "failed": 1
  },
  "cost": 5
}

Changes

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