> ## Documentation Index
> Fetch the complete documentation index at: https://www.adaline.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Evaluation results

# EvaluationResultsClient

`adaline.prompts.evaluations.results` returns per-row evaluation results as they become available, with optional grade and score filters. Because rows appear incrementally while an evaluation runs, you can poll this client to surface partial progress.

For long-running evaluations, prefer [`adaline.initEvaluationResults()`](/docs/reference/sdk/v2/typescript/classes/adaline#initevaluationresults) — it wraps this client in a self-refreshing cache.

## Access

```typescript theme={null}
import { Adaline } from '@adaline/client';

const adaline = new Adaline();
const results = adaline.prompts.evaluations.results; // EvaluationResultsClient
```

The class is also exported directly:

```typescript theme={null}
import { EvaluationResultsClient } from '@adaline/client';
import type { EvaluationResultsQuery } from '@adaline/client';
```

Types from `@adaline/api`:

```typescript theme={null}
import type { ListEvaluationResultsResponse } from '@adaline/api';
```

***

## list()

Fetch a page of evaluation results. Rows are returned as they become available, so you can poll this while an evaluation is still running to surface partial progress.

```typescript theme={null}
list(query: EvaluationResultsQuery): Promise<ListEvaluationResultsResponse>
```

### Parameters

| Name    | Type                                                                                  | Required | Description                         |
| ------- | ------------------------------------------------------------------------------------- | -------- | ----------------------------------- |
| `query` | [`EvaluationResultsQuery`](/docs/reference/sdk/v2/typescript/types/EvaluationResultsQuery) | Yes      | Identifiers + filters + pagination. |

[`EvaluationResultsQuery`](/docs/reference/sdk/v2/typescript/types/EvaluationResultsQuery) fields:

| Name           | Type                                                                 | Description                                |
| -------------- | -------------------------------------------------------------------- | ------------------------------------------ |
| `promptId`     | `string`                                                             | Prompt the evaluation belongs to.          |
| `evaluationId` | `string`                                                             | Evaluation to inspect.                     |
| `grade`        | `'pass' \| 'fail' \| 'unknown'`                                      | Optional filter by grade.                  |
| `expand`       | `'row'`                                                              | Include the underlying dataset row inline. |
| `sort`         | `'createdAt:asc' \| 'createdAt:desc' \| 'score:asc' \| 'score:desc'` | Sort order.                                |
| `limit`        | `number`                                                             | Page size.                                 |
| `cursor`       | `string`                                                             | Cursor from a previous response.           |

### Returns

`Promise<ListEvaluationResultsResponse>` with `{ data: EvaluationResult[]; pagination: Pagination }`. Each `EvaluationResult` has the evaluator's `grade`, `score`, `metadata`, and — if `expand: 'row'` was requested — the originating `row`.

### Example

```typescript theme={null}
const { data, pagination } = await adaline.prompts.evaluations.results.list({
  promptId: 'prompt_abc123',
  evaluationId: 'eval_abc123',
  grade: 'fail',
  expand: 'row',
  sort: 'score:desc',
  limit: 50,
});

for (const result of data) {
  console.log(`grade=${result.grade} score=${result.score}`);
}
```

For a self-refreshing cache rather than manual polling, use [`adaline.initEvaluationResults()`](/docs/reference/sdk/v2/typescript/classes/adaline#initevaluationresults).

***

## See Also

* [PromptEvaluationsClient](/docs/reference/sdk/v2/typescript/classes/prompt-evaluations) — parent client
* [EvaluationResultsQuery](/docs/reference/sdk/v2/typescript/types/EvaluationResultsQuery)
* [Adaline class](/docs/reference/sdk/v2/typescript/classes/adaline) — `initEvaluationResults()` polling helper
* API reference: [Get evaluation results](/docs/reference/api/v2/openapi/get-evaluation-results)