---
title: "Get Evaluation Results"
method: GET
path: "/v3/eval/results"
tags: ["Function Accuracy"]
---

# Get Evaluation Results

`GET /v3/eval/results`

**Fetch evaluation results for a batch of events.**

Pass either `eventIDs` (preferred — the externally-stable V3
identifier) or `transformationIDs` as a comma-separated query
parameter. Exactly one of the two must be provided. Up to 100 IDs per
request.

For each requested ID the response reports one of three states: a
completed `result`, still-`pending`, or `failed`. Results, pending,
and failed entries are all keyed by event KSUID regardless of which
input form was used.

## Query parameters

- `eventIDs` string
- `transformationIDs` string
- `evaluationVersion` string

## Response `200`

The request has succeeded.

- EvaluationResultsResponseV3 — Batched response containing the evaluation state for every requested ID, partitioned into completed `results`, still-running `pending`, and terminal `failed` groups. All identifiers in the response are event KSUIDs regardless of whether the request used `eventIDs` or `transformationIDs`.
  - `results` object, required — Completed evaluation results, keyed by event KSUID. An event appears here only if its evaluation completed successfully. Still-running evaluations appear in `pending`; failed evaluations appear in `failed`.
  - `pending` PendingEvaluationV3[] — Events whose evaluation is still running.
    - `eventID` string, required — Event KSUID.
    - `createdAt` string, date-time, required — Server timestamp when the evaluation was queued.
  - `failed` FailedEvaluationV3[] — Events whose evaluation failed or was not found.
    - `eventID` string, required — Event KSUID.
    - `errorMessage` string, required — Human-readable failure reason.
    - `createdAt` string, date-time, required — Server timestamp associated with the failure.
  - `errors` object — Reserved map of event KSUID to error message for validation failures on the request itself. Populated only in edge cases.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)