# Get batch evaluation results
<a name="batch-evaluations-get"></a>

Retrieve the status and results of a batch evaluation job. Poll this operation until the job reaches a terminal state (`COMPLETED`, `FAILED`, or `STOPPED`).

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

**Example**  
The CLI automatically polls `GetBatchEvaluation` when you run `agentcore run batch-evaluation`. To check the status of a previously started job, use the batch evaluation ID from the CLI output or from `ListBatchEvaluations`.

```
import time
import boto3

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

# Poll until terminal state
while True:
    result = client.get_batch_evaluation(batchEvaluationId=batch_eval_id)
    status = result["status"]
    print(f"Status: {status}")

    if status in ("COMPLETED", "COMPLETED_WITH_ERRORS", "FAILED", "STOPPED"):
        break
    time.sleep(30)

# Display results
if result.get("evaluationResults"):
    er = result["evaluationResults"]
    print(f"Sessions completed: {er.get('numberOfSessionsCompleted', 0)}")
    print(f"Sessions failed:    {er.get('numberOfSessionsFailed', 0)}")
    print(f"Total sessions:     {er.get('totalNumberOfSessions', 0)}")

    for summary in er.get("evaluatorSummaries", []):
        avg = summary.get("statistics", {}).get("averageScore")
        print(f"  {summary['evaluatorId']}: {avg}")
```

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


| Parameter | Type | Required | Description | 
| --- | --- | --- | --- | 
|  `batchEvaluationId`  | String | Yes | The batch evaluation ID returned by `StartBatchEvaluation`. Passed as a path parameter. | 

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


| Field | Type | Description | 
| --- | --- | --- | 
|  `batchEvaluationId`  | String | The batch evaluation ID. | 
|  `batchEvaluationArn`  | String | ARN of the batch evaluation. | 
|  `batchEvaluationName`  | String | The 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. | 
|  `outputConfig`  | Object | CloudWatch Logs destination for per-session detail. Contains `cloudWatchConfig.logGroupName` and `cloudWatchConfig.logStreamName`. | 
|  `evaluationResults`  | Object | Present when the job has processed sessions. See [Understanding results and output](batch-evaluations-results.md). | 
|  `errorDetails`  | List of strings | Error messages if the job failed. | 

### evaluationResults fields
<a name="get-batch-eval-results-fields"></a>


| Field | Type | Description | 
| --- | --- | --- | 
|  `numberOfSessionsCompleted`  | Integer | Number of sessions successfully evaluated. | 
|  `numberOfSessionsFailed`  | Integer | Number of sessions that failed evaluation. | 
|  `numberOfSessionsInProgress`  | Integer | Number of sessions still being evaluated. | 
|  `totalNumberOfSessions`  | Integer | Total number of sessions discovered. | 
|  `numberOfSessionsIgnored`  | Integer | Number of sessions ignored for evaluation. The service evaluates up to 500 sessions per job; if more are discovered, the most recent 500 are selected. | 
|  `evaluatorSummaries`  | List | Per-evaluator aggregate results. | 

### evaluatorSummaries fields
<a name="get-batch-eval-summaries-fields"></a>


| Field | Type | Description | 
| --- | --- | --- | 
|  `evaluatorId`  | String | Evaluator ID (for example, `Builtin.GoalSuccessRate`). | 
|  `statistics.averageScore`  | Double | Average score across all evaluated sessions. | 
|  `totalEvaluated`  | Integer | Number of sessions this evaluator scored. | 
|  `totalFailed`  | Integer | Number of sessions where this evaluator failed. | 

## Status lifecycle
<a name="get-batch-eval-status-lifecycle"></a>

```
PENDING → IN_PROGRESS → COMPLETED
                      → COMPLETED_WITH_ERRORS
                      → FAILED
         STOPPING     → STOPPED
         DELETING
```
+  **PENDING** — The job has been accepted and is queued for processing.
+  **IN\_PROGRESS** — The service is discovering sessions and running evaluators.
+  **COMPLETED** — All sessions have been evaluated. Results are available.
+  **COMPLETED\_WITH\_ERRORS** — The job finished but some sessions encountered errors. Partial results are available.
+  **FAILED** — The job encountered an error. Check `errorDetails` for details.
+  **STOPPING** — A stop request has been received. The job is winding down.
+  **STOPPED** — The job was stopped before completion. Partial results may be available.
+  **DELETING** — The job is being deleted.

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


| Error | HTTP status | Description | 
| --- | --- | --- | 
|  `ResourceNotFoundException`  | 404 | No batch evaluation found with the specified ID. | 
|  `ValidationException`  | 400 | Invalid batch evaluation ID format. | 
|  `AccessDeniedException`  | 403 | Insufficient permissions. | 
|  `ThrottlingException`  | 429 | Request rate exceeded. | 
|  `InternalServerException`  | 500 | Service-side error. |