---
title: "Changes to List batches (v2)"
method: GET
path: "/api/v2alpha/batches"
---

# Changes to List batches (v2)

`GET /api/v2alpha/batches`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 14 revisions.

- **2026-06-04** `a545b6b19c2b`: 1 info
- **2025-09-11** `1ceb0d26f60f`: 1 breaking, 15 info
- **2025-04-16** `afa3b61d1d09`: 10 info
- **2025-01-14** `559a91071cc1`: 4 warning, 5 info

## Changes

- **2026-06-04** `a545b6b19c2b`: 1 info
  - the endpoint scheme security `developerAuth` was removed from the API
- **2025-09-11** `1ceb0d26f60f`: 1 breaking, 15 info
  - the `batches/items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `batches/items/attributes` to the response with the `200` status
  - added the optional property `batches/items/billing_project` to the response with the `200` status
  - added the optional property `batches/items/closed` to the response with the `200` status
  - added the optional property `batches/items/complete` to the response with the `200` status
  - added the optional property `batches/items/id` to the response with the `200` status
  - added the optional property `batches/items/n_cancelled` to the response with the `200` status
  - added the optional property `batches/items/n_completed` to the response with the `200` status
  - added the optional property `batches/items/n_failed` to the response with the `200` status
  - added the optional property `batches/items/n_jobs` to the response with the `200` status
  - added the optional property `batches/items/n_succeeded` to the response with the `200` status
  - added the optional property `batches/items/state` to the response with the `200` status
  - added the optional property `batches/items/time_completed` to the response with the `200` status
  - added the optional property `batches/items/time_created` to the response with the `200` status
  - added the optional property `batches/items/token` to the response with the `200` status
  - added the optional property `batches/items/user` to the response with the `200` status
- **2025-04-16** `afa3b61d1d09`: 10 info
  - api operation id `getBatchesv2alpha` removed and replaced with ``
  - the endpoint scheme security `developerAuth` was added to the API
  - api tag `Batches` added
  - api tag `Batches API v2Alpha` removed
  - added the new optional `query` request parameter `last_batch_id`
  - added the new optional `query` request parameter `q`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the optional property `batches` to the response with the `200` status
  - added the optional property `last_batch_id` to the response with the `200` status
- **2025-01-14** `559a91071cc1`: 4 warning, 5 info
  - deleted the `query` request parameter `last_batch_id`
  - deleted the `query` request parameter `q`
  - removed the optional property `batches` from the response with the `200` status
  - removed the optional property `last_batch_id` from the response with the `200` status
  - api operation id `getBatchesv2alpha` was added
  - api tag `Batches API v2Alpha` added
  - api tag `Batches` removed
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`

---

[Operation](https://skmtc.dev/hail-is/apis/hail-services/docs/api/v2alpha/batches/get.md) - [API](https://skmtc.dev/hail-is/apis/hail-services.md) - [Page](https://skmtc.dev/hail-is/apis/hail-services/changes/api/v2alpha/batches/get)