List batches | Qwen Cloud

GET

/batches

Python

from openai import OpenAI
import os

client = OpenAI(
  api_key=os.getenv("DASHSCOPE_API_KEY"),
  base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

batches = client.batches.list(limit=2)

for batch in batches.data:
    print(batch.id, batch.status)

{
  "object": "list",
  "data": [
    {
      "id": "batch_abc123",
      "object": "batch",
      "endpoint": "/v1/chat/completions",
      "errors": {
        "object": "list",
        "data": [
          {
            "code": "<string>",
            "message": "<string>",
            "param": "<string>",
            "line": 0
          }
        ]
      },
      "input_file_id": "file-abc123",
      "completion_window": "24h",
      "status": "validating",
      "output_file_id": "file-xyz789",
      "error_file_id": "file-err456",
      "created_at": 1735113344,
      "in_progress_at": 0,
      "expires_at": 0,
      "finalizing_at": 0,
      "completed_at": 0,
      "failed_at": 0,
      "expired_at": 0,
      "cancelled_at": 0,
      "cancelling_at": 0,
      "request_counts": {
        "total": 0,
        "completed": 0,
        "failed": 0
      },
      "metadata": {
        "ds_name": "<string>",
        "ds_description": "<string>"
      }
    }
  ],
  "first_id": "batch_abc123",
  "last_id": "batch_abc456",
  "has_more": false
}

Authorizations

string

header

required

Qwen Cloud API Key. Create one in the console.

Query Parameters

string

Cursor for pagination. Value is the ID of the last batch on the previous page.

Example:batch_abc123

integer

default20

Number of batches to return per page. Range: [1, 100]. Default: 20.

Example:20

Required range:1 <= x <= 100

string

Fuzzy match by task name.

string

Filter by input file ID. Multiple IDs separated by commas, up to 20.

Example:file-batch-xxx,file-batch-yyy

string

Filter by task status. Multiple statuses separated by commas. Values: validating, in_progress, finalizing, completed, failed, expired, cancelling, cancelled.

Example:completed,expired

string

Filter tasks created after this time point. Format: yyyyMMddHHmmss.

Example:20250304000000

string

Filter tasks created before this time point. Format: yyyyMMddHHmmss.

Example:20250306123000

Response

200-application/json

enum<string>

Always list.

Available options:list

object[]

List of batch objects.

Show child attributes

string

Unique batch job identifier.

Example:batch_abc123

enum<string>

Always "batch".

Available options:batch

string

The API endpoint used for this batch.

Example:/v1/chat/completions

object | null

Errors encountered during batch processing.

Show child attributes

enum<string>

Always "list".

Available options:list

object[]

List of error details.

Show child attributes

string

Error code.

string

Human-readable error message.

string | null

Parameter that caused the error.

integer | null

Line number in the input file that caused the error.

string

ID of the input file.

Example:file-abc123

string

The completion window for the batch job.

Example:24h

enum<string>

Current status of the batch job. validating: input file is being validated. in_progress: batch is being processed. finalizing: results are being compiled. completed: all requests finished. failed: job failed. expired: job exceeded the completion window. cancelling: cancellation in progress. cancelled: job was cancelled.

Available options:validating,in_progress,finalizing,completed,failed,expired,cancelling,cancelled

string | null

ID of the file containing successful results. Available when status is completed. Use with the download file content endpoint.

Example:file-xyz789

string | null

ID of the file containing error details. Available when some requests failed. Use with the download file content endpoint.

Example:file-err456

integer

Unix timestamp (seconds) when the batch was created.

Example:1735113344

integer | null

Unix timestamp (seconds) when the batch started processing.

integer | null

Unix timestamp (seconds) when the batch will expire.

integer | null

Unix timestamp (seconds) when the batch started finalizing.

integer | null

Unix timestamp (seconds) when the batch completed.

integer | null

Unix timestamp (seconds) when the batch failed.

integer | null

Unix timestamp (seconds) when the batch expired.

integer | null

Unix timestamp (seconds) when the batch was cancelled.

integer | null

Unix timestamp (seconds) when the batch entered cancelling status.

object

Request processing counts.

Show child attributes

integer

Total number of requests in the batch.

integer

Number of requests that completed successfully.

integer

Number of requests that failed.

object | null

Key-value metadata attached to the batch.

Show child attributes

string

Task name.

string

Task description.

string | null

ID of the first batch in the list.

Example:batch_abc123

string | null

ID of the last batch in the list.

Example:batch_abc456

boolean

Whether there are more batches available after this page.