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

# EvaluationResultsQuery

# EvaluationResultsQuery

The query object passed to [`EvaluationResultsClient.list()`](/docs/reference/sdk/v2/typescript/classes/evaluation-results#list) and [`Adaline.initEvaluationResults()`](/docs/reference/sdk/v2/typescript/classes/adaline#initevaluationresults). Combines identifiers, filters, and pagination in a single shape so that polling helpers can replay the same query on every refresh.

## Definition

```typescript theme={null}
interface EvaluationResultsQuery {
  promptId: string;
  evaluationId: string;
  grade?: 'pass' | 'fail' | 'unknown';
  expand?: 'row';
  sort?: 'createdAt:asc' | 'createdAt:desc' | 'score:asc' | 'score:desc';
  limit?: number;
  cursor?: string;
}
```

## Fields

| Field          | Type                                                                 | Description                                                                |
| -------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| `promptId`     | `string`                                                             | Prompt the evaluation belongs to. Required.                                |
| `evaluationId` | `string`                                                             | Evaluation whose results you want. Required.                               |
| `grade`        | `'pass' \| 'fail' \| 'unknown'`                                      | Only return rows with this grade.                                          |
| `expand`       | `'row'`                                                              | If `"row"`, each result includes its underlying dataset row.               |
| `sort`         | `'createdAt:asc' \| 'createdAt:desc' \| 'score:asc' \| 'score:desc'` | Sort order.                                                                |
| `limit`        | `number`                                                             | Page size.                                                                 |
| `cursor`       | `string`                                                             | Opaque cursor returned by the previous response's `pagination.nextCursor`. |

## Usage

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

const query: EvaluationResultsQuery = {
  promptId: 'prompt_abc123',
  evaluationId: 'eval_abc123',
  grade: 'fail',
  expand: 'row',
  sort: 'score:desc',
  limit: 50,
};

// One-shot fetch
const page = await adaline.prompts.evaluations.results.list(query);

// Or keep a polling cache refreshed in the background
const results = await adaline.initEvaluationResults({
  query,
  refreshInterval: 30,
});
```

## See Also

* [EvaluationResultsClient](/docs/reference/sdk/v2/typescript/classes/evaluation-results)
* [PromptEvaluationsClient](/docs/reference/sdk/v2/typescript/classes/prompt-evaluations)
* [Adaline.initEvaluationResults()](/docs/reference/sdk/v2/typescript/classes/adaline#initevaluationresults)
* [BackgroundStatus](/docs/reference/sdk/v2/typescript/types/BackgroundStatus)