---
title: "GET /evaluations/batch-evaluate"
method: GET
path: "/evaluations/batch-evaluate"
---

# GET /evaluations/batch-evaluate

`GET /evaluations/batch-evaluate`

Lists all batch evaluations in the account, providing summary information about each evaluation's status and configuration.

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListBatchEvaluationsResponse
  - `batchEvaluations` BatchEvaluationSummary[], required — The list of batch evaluation summaries.
    - `batchEvaluationId` string, required — The unique identifier of the batch evaluation.
    - `batchEvaluationArn` string, required — The Amazon Resource Name (ARN) of the batch evaluation.
    - `batchEvaluationName` string, required — The name of the batch evaluation.
    - `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'COMPLETED_WITH_ERRORS' | 'FAILED' | 'STOPPING' | 'STOPPED' | 'DELETING', required — The current status of the batch evaluation.
    - `createdAt` string, date-time, required — The timestamp when the batch evaluation was created.
    - `description` string — The description of the batch evaluation.
    - `evaluators` Evaluator[] — The list of evaluators applied during the batch evaluation.
      - `evaluatorId` string, required — The unique identifier of the evaluator. Can reference built-in evaluators (e.g., <code>Builtin.Helpfulness</code>) or custom evaluators.
    - `insights` Insight[] — The list of insight analyses applied during the batch evaluation.
      - `insightId` string, required — The unique identifier of the insight to run.
    - `evaluationResults` object — The aggregated evaluation results.
      - `numberOfSessionsCompleted` integer — The number of sessions that have been successfully evaluated.
      - `numberOfSessionsInProgress` integer — The number of sessions currently being evaluated.
      - `numberOfSessionsFailed` integer — The number of sessions that failed evaluation.
      - `totalNumberOfSessions` integer — The total number of sessions included in the batch evaluation.
      - `numberOfSessionsIgnored` integer — The number of sessions that were ignored during evaluation.
      - `evaluatorSummaries` EvaluatorSummary[] — A list of per-evaluator summary statistics.
        - `evaluatorId` string — The unique identifier of the evaluator.
        - `statistics` object — The aggregated statistics for this evaluator.
          - `averageScore` number, double — The average score across all evaluated sessions for this evaluator.
        - `totalEvaluated` integer — The total number of sessions evaluated by this evaluator.
        - `totalFailed` integer — The total number of sessions that failed evaluation by this evaluator.
    - `errorDetails` ErrorDetailsListMemberString[] — The error details if the batch evaluation encountered failures.
    - `kmsKeyArn` string — The ARN of the KMS key used to encrypt evaluation data.
    - `updatedAt` string, date-time — The timestamp when the batch evaluation was last updated.
  - `nextToken` string — If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.

## Other responses

- `480` — UnauthorizedException
- `481` — ValidationException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore/versions/79623b33d495/schema)