---
title: "Get Batch Session Status"
method: GET
path: "/v1/batch-sessions/{batch_id}"
tags: ["Batch Sessions"]
---

# Get Batch Session Status

`GET /v1/batch-sessions/{batch_id}`

Retrieves detailed status information for a specific batch, including progress,
individual session details, and any errors that occurred.

## Path parameters

- `batch_id` string, uuid, required

## Response `200`

Batch status retrieved successfully

- object
  - `data` BatchSessionStatusResponseSchema
    - `batch_id` string, uuid — Unique identifier for the batch
    - `status` 'pending' | 'processing' | 'completed' | 'failed' — Current status of the batch
    - `total_requests` integer — Total number of sessions requested
    - `completed_requests` integer — Number of sessions successfully created
    - `failed_requests` integer — Number of sessions that failed to create
    - `processing_requests` integer — Number of sessions currently being processed
    - `pending_requests` integer — Number of sessions waiting to be processed
    - `created_at` string, date-time — Timestamp when the batch was created
    - `actual_completion_time` string, date-time — Timestamp when the batch completed (if completed)
    - `error` string — Error message if batch failed
    - `sessions` BatchSessionItemSchema[] — Array of individual session details
      - `item_index` integer — Index of this session within the batch (0-based)
      - `session_id` string, uuid — Unique identifier for the browser session (if created successfully)
      - `status` 'pending' | 'processing' | 'completed' | 'failed' — Current status of this individual session
      - `cdp_url` string — CDP websocket connection URL (if session is ready)
      - `live_view_url` string — Live view URL for the session (if session is ready)
      - `error` string — Error message if session creation failed
      - `retry_count` integer — Number of times this session creation has been retried
      - `started_at` string, date-time — Timestamp when session creation started
      - `completed_at` string, date-time — Timestamp when session creation completed
      - `metadata` object — Session-specific metadata
    - `progress` object
      - `percentage` number — Completion percentage (0-100)
      - `current_phase` 'queued' | 'provisioning' | 'configuring' | 'ready' — Current processing phase

## Other responses

- `401` — Invalid API Key
- `404` — Batch not found
- `500` — Internal server error

## Changes

- **2025-10-19** `c1801bdad04f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/batch-sessions/:batch_id/get.md)

---

[API](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api.md) · [All operations](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/anchorbrowser/anchorbrowser-api/revisions/209d6495e3ef/schema)