> ## 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. Every method is async.

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

## Access

```python theme={null}
from adaline.main import Adaline

adaline = Adaline()
results = adaline.prompts.evaluations.results  # EvaluationResultsClient
```

The class is also exported directly:

```python theme={null}
from adaline.clients import EvaluationResultsClient
```

Types from `adaline_api`:

```python theme={null}
from adaline_api.models.list_evaluation_results_response import ListEvaluationResultsResponse
```

***

## 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.

```python theme={null}
async def list(
    *,
    prompt_id: str,
    evaluation_id: str,
    grade: Optional[str] = None,
    expand: Optional[str] = None,
    sort: Optional[str] = None,
    limit: Optional[int] = None,
    cursor: Optional[str] = None,
) -> ListEvaluationResultsResponse
```

### Parameters

| Name            | Type            | Required | Description                                                              |
| --------------- | --------------- | -------- | ------------------------------------------------------------------------ |
| `prompt_id`     | `str`           | Yes      | Prompt the evaluation belongs to.                                        |
| `evaluation_id` | `str`           | Yes      | Evaluation to inspect.                                                   |
| `grade`         | `Optional[str]` | No       | `"pass"`, `"fail"`, or `"unknown"`.                                      |
| `expand`        | `Optional[str]` | No       | `"row"` to include the underlying dataset row inline.                    |
| `sort`          | `Optional[str]` | No       | `"createdAt:asc"`, `"createdAt:desc"`, `"score:asc"`, or `"score:desc"`. |
| `limit`         | `Optional[int]` | No       | Page size.                                                               |
| `cursor`        | `Optional[str]` | No       | Cursor from a previous response.                                         |

See [EvaluationResultsQuery](/docs/reference/sdk/v2/python/types/EvaluationResultsQuery) for the full shape.

### Returns

[`ListEvaluationResultsResponse`](/docs/reference/api/v2/openapi/get-evaluation-results) with `{ data: list[EvaluationResult]; pagination: Pagination }`.

### Example

```python theme={null}
response = await adaline.prompts.evaluations.results.list(
    prompt_id="prompt_abc123",
    evaluation_id="eval_abc123",
    grade="fail",
    expand="row",
    sort="score:desc",
    limit=50,
)

for result in response.data:
    print(f"grade={result.grade} score={result.score}")
```

***

## See Also

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