---
title: "List batch executions"
method: GET
path: "/v2/batch-executions"
tags: ["Batch Executions"]
---

# List batch executions

`GET /v2/batch-executions`

## Request

- Base URL: `https://app.aiva.works` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aiva.works/v2/batch-executions`
- Auth: API key in header `X-API-KEY`

Lists batch executions, newest first, with their status and test counts.

## Query parameters

- `executionIds` string[]
- `labels` string[]
- `status` 'Enqueued' | 'Running' | 'Succeeded' | 'Failed' | 'Cancelled' | 'Skipped' | 'Completed'
- `enqueuedAfter` string, date-time
- `enqueuedBefore` string, date-time
- `page` integer
- `pageSize` integer

## Response `200`

Array of batch execution summaries

- BatchExecutionSummary[]
  - `id` string, guid, required
  - `batchId` string, guid, nullable
  - `name` string, nullable
  - `status` 'Enqueued' | 'Running' | 'Succeeded' | 'Failed' | 'Cancelled' | 'Skipped' | 'Completed', required
  - `enqueuedAt` string, date-time, required
  - `finishedAt` string, date-time, nullable
  - `triggerSource` 'UI' | 'Api' | 'Scheduled'
  - `passed` integer, required
  - `failed` integer, required
  - `total` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: User does not have permission to access batches
- `500`: Server Error

---

[API](https://skmtc.dev/aiva/apis/aiva-cloud-api.md) · [All operations](https://skmtc.dev/aiva/apis/aiva-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aiva/apis/aiva-cloud-api/revisions/70eef14d3bcd?raw)