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

# Listing Evaluations

> List all evaluations associated with a specific session.

> [!WARNING]
>
> You are reading the docs of Galtea 5.17. [Read this page in the latest version](https://docs.galtea.ai/sdk/api/evaluation/list.md).

## Returns

Returns a list of [Evaluation](https://docs.galtea.ai/v5.17/concepts/product/version/session/evaluation.md) objects.

## Example

```python theme={"system"}
evaluations = galtea.evaluations.list(session_id=session_id)
```

## Parameters

**id** `str | list[str]` (default: None)

The ID or IDs of the evaluation(s) to retrieve.

**session\_id** `str | list[str]` (default: None)

The ID or IDs of the session(s) for which you want to list evaluations.

**version\_id** `str` (default: None)

The ID of the version for which you want to list evaluations.

**test\_case\_id** `str | list[str]` (default: None)

The ID or IDs of the test case(s) for which you want to list evaluations.

**dataset\_id** `str | list[str]` (default: None)

The ID or IDs of the dataset(s) for which you want to list evaluations.

> [!NOTE]
>
> Deprecated alias: `test_id`.

**metric\_id** `str | list[str]` (default: None)

The ID or IDs of the metric(s) for which you want to list evaluations.

**status** `str | list[str]` (default: None)

Filter by evaluation status(es). Valid values are `'PENDING'`, `'PENDING_HUMAN'`, `'SUCCESS'`, `'FAILED'`, `'SKIPPED'`, `'CANCELLED'`, `'OUTDATED'`. Other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.

**from\_created\_at** `str | int` (default: None)

Filter evaluations created at or after this timestamp. Accepts ISO 8601 string (e.g., `'2024-01-01T00:00:00Z'`) or Unix timestamp in seconds. Can be used independently or together with `to_created_at`.

**to\_created\_at** `str | int` (default: None)

Filter evaluations created at or before this timestamp. Accepts ISO 8601 string (e.g., `'2024-12-31T23:59:59Z'`) or Unix timestamp in seconds. Can be used independently or together with `from_created_at`.

**sort\_by\_created\_at** `string`

Sort evaluations by creation date. Valid values are "asc" and "desc".

**sort\_by\_score** `string`

Sort evaluations by score. Valid values are "asc" and "desc".

**offset** `int` (default: 0)

Number of evaluations to skip before starting to collect results. Use for pagination.

**Default:** `0` (start from the beginning)

**limit** `int` (default: 10000)

Maximum number of evaluations to return in a single request.

**Default:** `10000`

**user\_id** `str | list[str]` (default: None)

Filter by the ID of the user who launched the evaluation. Null for a monitor-dispatched evaluation. This is an additional filter; it does not satisfy the scoping requirement below.

**run\_id** `str | list[str]` (default: None)

The ID or IDs of the [Runs](https://docs.galtea.ai/v5.17/concepts/product/run.md) that launched the evaluations to retrieve. A monitor-dispatched evaluation belongs to no run, so it never matches.

**include\_excluded\_from\_analytics** `bool` (default: False)

Keyword-only. Include evaluations whose metric revision is excluded from analytics. These results keep their score and reason, but they do not feed any analytics number. See [Metrics](https://docs.galtea.ai/v5.17/concepts/metric.md).

**score\_gt** `float` (default: None)

Keyword-only. Keep evaluations whose judge score is greater than this value, on the 0 to 1 scale. This is the judge's score, not the human review. An evaluation with no judge score never matches. A value outside 0 to 1 raises `ValueError`.

**score\_gte** `float` (default: None)

Keyword-only. Keep evaluations whose judge score is greater than or equal to this value, on the 0 to 1 scale. This is the judge's score, not the human review. An evaluation with no judge score never matches. A value outside 0 to 1 raises `ValueError`.

**score\_lt** `float` (default: None)

Keyword-only. Keep evaluations whose judge score is less than this value, on the 0 to 1 scale. This is the judge's score, not the human review. An evaluation with no judge score never matches. A value outside 0 to 1 raises `ValueError`.

**score\_lte** `float` (default: None)

Keyword-only. Keep evaluations whose judge score is less than or equal to this value, on the 0 to 1 scale. This is the judge's score, not the human review. An evaluation with no judge score never matches. A value outside 0 to 1 raises `ValueError`.

**human\_score\_gt** `float` (default: None)

Keyword-only. Keep evaluations whose human review score is greater than this value, on the 0 to 1 scale. An evaluation with no human score never matches. A value outside 0 to 1 raises `ValueError`.

**human\_score\_gte** `float` (default: None)

Keyword-only. Keep evaluations whose human review score is greater than or equal to this value, on the 0 to 1 scale. An evaluation with no human score never matches. A value outside 0 to 1 raises `ValueError`.

**human\_score\_lt** `float` (default: None)

Keyword-only. Keep evaluations whose human review score is less than this value, on the 0 to 1 scale. An evaluation with no human score never matches. A value outside 0 to 1 raises `ValueError`.

**human\_score\_lte** `float` (default: None)

Keyword-only. Keep evaluations whose human review score is less than or equal to this value, on the 0 to 1 scale. An evaluation with no human score never matches. A value outside 0 to 1 raises `ValueError`.

**passed** `bool` (default: None)

Keyword-only. `True` keeps the evaluations whose score reaches their metric's pass threshold, and `False` keeps the ones below it. An evaluation with no result never matches either value.

> [!TIP]
>
> To match one exact score, pass the same value as both inclusive bounds: `score_gte=0.5, score_lte=0.5` for the judge score, or `human_score_gte=0.5, human_score_lte=0.5` for the human score.

> [!NOTE]
>
> At least one of the scoping filters (`id`, `session_id`, `version_id`, `test_case_id`, `dataset_id`, `metric_id`, `run_id`) described above must be passed to the method. `status`, `user_id`, `passed` and the score bounds are additional filters and do **not** satisfy this requirement on their own.


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