> ## 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()`](https://www.adaline.ai/docs/reference/sdk/v2/typescript/classes/evaluation-results#list) and [`Adaline.initEvaluationResults()`](https://www.adaline.ai/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](https://www.adaline.ai/docs/reference/sdk/v2/typescript/classes/evaluation-results.md)
* [PromptEvaluationsClient](https://www.adaline.ai/docs/reference/sdk/v2/typescript/classes/prompt-evaluations.md)
* [Adaline.initEvaluationResults()](https://www.adaline.ai/docs/reference/sdk/v2/typescript/classes/adaline.md#initevaluationresults)
* [BackgroundStatus](https://www.adaline.ai/docs/reference/sdk/v2/typescript/types/BackgroundStatus.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.