---
title: "Public List Batches"
method: GET
path: "/v1/batches"
tags: ["public-api"]
---

# Public List Batches

`GET /v1/batches`

## Request

- Base URL: `https://api.trainloop.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.trainloop.ai/v1/batches`
- Auth: none declared

One page of the team's batches, newest first. ``total`` is the count
behind the filters; page with ``offset``.

## Query parameters

- `pipeline` string, nullable
- `status` 'queued' | 'dispatched' | 'running' | 'completed' | 'completed_with_errors' | 'failed' | 'cancelled', nullable
- `offset` integer
- `limit` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- BatchListResponse: One page of the team's batches, newest first.
  - `batches` BatchResponse[], required
    - `id` string, uuid, required
    - `pipeline` string, required
    - `status` 'queued' | 'dispatched' | 'running' | 'completed' | 'completed_with_errors' | 'failed' | 'cancelled', required
    - `connection_id` string, uuid, required
    - `input_path` string, required
    - `output_path` string, required
    - `options` object, required
    - `item_total` integer, required
    - `item_done` integer, required
    - `item_skipped` integer, required
    - `item_failed` integer, required
    - `error` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
  - `total` integer, required
  - `offset` integer, required
  - `limit` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-09** `dec6fd242e40`: 6 info
  - api operation id `list_batches_v1_batches_get` removed and replaced with `public_list_batches_v1_batches_get`
  - api tag `batches` removed
  - added the new optional `query` request parameter `offset`
  - added the required property `limit` to the response with the `200` status
  - …2 more
- **2026-09-09** `26478f75ef09`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trainloop/apis/trainloop-api/changes/v1/batches/get.md)

---

[API](https://skmtc.dev/trainloop/apis/trainloop-api.md) - [All operations](https://skmtc.dev/trainloop/apis/trainloop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trainloop/apis/trainloop-api/revisions/f11e38cf6836?raw)