---
title: "List batches"
method: GET
path: "/v2/batches"
tags: ["batches"]
---

# List batches

`GET /v2/batches`

Return a list of batches. Use query parameters to filter results.

## Query parameters

- `workspace` string
- `username` string
- `limit` integer
- `offset` integer

## Headers

- `Authorization` string, required
- `IB-Context` string

## Response `200`

Request successful.

- BatchesListBatchesResponse200
  - `batches` BatchInfo[] — List of batches. See response schema for each batch object.
    - `id` integer, required — The batch ID.
    - `name` string, required — The batch name.
    - `workspace` string — The name of the workspace in which the batch exists.
    - `mount_point` string — The name of the connected drive in which the batch is stored.
    - `repo_owner` string — The owner of the workspace (also known as the repo) in which the batch exists.
    - `batch_owner` string — Username of the user that created the batch.
    - `created_at_ms` integer — When the batch was created, in Unix time milliseconds.
    - `updated_at_ms` integer — When the batch was last updated, in Unix time milliseconds.
    - `path_suffix` string — Batch path suffix from the mount point.

---

[API](https://skmtc.net/instabase/apis/api-reference.md) · [All operations](https://skmtc.net/instabase/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instabase/api-reference/revisions/3a4f46d48141/schema)