---
title: "Get a Batch's Evaluations"
method: GET
path: "/batches/{batch_token}/evaluations"
tags: ["Batches"]
---

# Get a Batch's Evaluations

`GET /batches/{batch_token}/evaluations`

## Request

- Base URL: `https://sandbox.alloy.co/v1`
- URL: `https://sandbox.alloy.co/v1/batches/{batch_token}/evaluations`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `/oauth/bearer`
  - HTTP basic
- TypeScript: <https://skmtc.dev/alloy/apis/alloy-api/docs/batches/:batch_token/evaluations/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of the evaluations belonging to a batch.

## Query parameters

- `evaluation_status` string
- `evaluation_result` string
- `row_status` string
- `outcome` string
- `page` integer
- `per_page` integer

## Response `200`

Batch evaluations

- object
  - `status_code` number
  - `error` object, nullable
  - `_links` object
    - `self` BatchLink
      - `href` string
    - `next` BatchLink
      - `href` string
    - `prev` BatchLink
      - `href` string
    - `batch` BatchLink
      - `href` string
  - `_embedded` object
    - `evaluations` object[]
  - `page` integer
  - `per_page` integer

## Changes

- **2026-11-03** `615aa97a5ddb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alloy/apis/alloy-api/changes/batches/:batch_token/evaluations/get.md)

---

[API](https://skmtc.dev/alloy/apis/alloy-api.md) - [All operations](https://skmtc.dev/alloy/apis/alloy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alloy/apis/alloy-api/revisions/615aa97a5ddb?raw)