---
title: "List Batch Sessions"
method: GET
path: "/v1/batch-sessions"
tags: ["Batch Sessions"]
---

# List Batch Sessions

`GET /v1/batch-sessions`

## Request

- Base URL: `https://api.anchorbrowser.io`
- URL: `https://api.anchorbrowser.io/v1/batch-sessions`
- Auth: API key in header `anchor-api-key`

Lists all batch session requests for the authenticated team, with optional filtering
by status and pagination support.

## Query parameters

- `status` 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled'
- `page` integer
- `limit` integer
- `created_after` string, date-time
- `created_before` string, date-time

## Response `200`

Batch list retrieved successfully

- object
  - `data` BatchSessionListResponseSchema
    - `batches` BatchSessionListItemSchema[]: Array of batch session summaries
      - `batch_id` string, uuid: Unique identifier for the batch
      - `status` 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled': Current status of the batch
      - `total_requests` integer: Total number of sessions requested
      - `completed_requests` integer: Number of sessions successfully completed
      - `failed_requests` integer: Number of sessions that failed
      - `created_at` string, date-time: Timestamp when the batch was created
      - `actual_completion_time` string, date-time: Timestamp when the batch completed (if completed)
    - `pagination` object
      - `current_page` integer: Current page number
      - `total_pages` integer: Total number of pages
      - `total_records` integer: Total number of batch records
      - `has_next` boolean: Whether there is a next page
      - `has_prev` boolean: Whether there is a previous page

## Other responses

- `401`: Invalid API Key
- `500`: Internal server error

## Changes

- **2026-10-16** `b3bfdb98c79e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/batch-sessions/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.dev/anchorbrowser/apis/anchorbrowser-api/revisions/9d755f22df0e?raw)