# List batch evaluations
<a name="batch-evaluations-list"></a>

List all batch evaluation jobs in your account. Results are paginated.

## Code samples
<a name="list-batch-eval-examples"></a>

**Example**  

```
import boto3

client = boto3.client("bedrock-agentcore", region_name="us-west-2")

# List all batch evaluations
paginator_token = None
all_evaluations = []

while True:
    params = {"maxResults": 50}
    if paginator_token:
        params["nextToken"] = paginator_token

    response = client.list_batch_evaluations(**params)
    all_evaluations.extend(response["batchEvaluations"])

    paginator_token = response.get("nextToken")
    if not paginator_token:
        break

for evaluation in all_evaluations:
    print(
        f"{evaluation['batchEvaluationId']}  "
        f"{evaluation['batchEvaluationName']}  "
        f"{evaluation['status']}  "
        f"{evaluation['createdAt']}"
    )
```

## Request parameters
<a name="list-batch-eval-params"></a>


| Parameter | Type | Required | Description | 
| --- | --- | --- | --- | 
|   `maxResults`   |  Integer  |  No  |  Maximum number of results per page. Range: 1–100. Default: service-defined.  | 
|   `nextToken`   |  String  |  No  |  Pagination token from a previous response.  | 

## Response
<a name="list-batch-eval-response"></a>


| Field | Type | Description | 
| --- | --- | --- | 
|   `batchEvaluations`   |  List  |  List of batch evaluation summaries.  | 
|   `nextToken`   |  String  |  Pagination token for the next page. Absent when there are no more results.  | 

### Batch evaluation summary fields
<a name="list-batch-eval-summary-fields"></a>


| Field | Type | Description | 
| --- | --- | --- | 
|   `batchEvaluationId`   |  String  |  Unique identifier.  | 
|   `batchEvaluationArn`   |  String  |  ARN of the batch evaluation.  | 
|   `batchEvaluationName`   |  String  |  Job name.  | 
|   `status`   |  String  |  Current status: `PENDING`, `IN_PROGRESS`, `COMPLETED`, `COMPLETED_WITH_ERRORS`, `FAILED`, `STOPPING`, `STOPPED`, `DELETING`.  | 
|   `createdAt`   |  Timestamp  |  When the job was created.  | 
|   `evaluators`   |  List  |  The evaluators used.  | 
|   `evaluationResults`   |  Object  |  Aggregate results summary. Present when the job has completed.  | 
|   `errorDetails`   |  List of strings  |  Error messages if the job failed.  | 

## Errors
<a name="list-batch-eval-errors"></a>


| Error | HTTP status | Description | 
| --- | --- | --- | 
|   `ValidationException`   |  400  |  Invalid pagination parameters.  | 
|   `AccessDeniedException`   |  403  |  Insufficient permissions.  | 
|   `ThrottlingException`   |  429  |  Request rate exceeded.  | 
|   `InternalServerException`   |  500  |  Service-side error.  |