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

## Returns

Returns a list of [Evaluation](/concepts/product/version/session/evaluation) objects.

## Example

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

## Parameters

<ResponseField name="id" type="str | list[str]" default="None">
  The ID or IDs of the evaluation(s) to retrieve.
</ResponseField>

<ResponseField name="session_id" type="str | list[str]" default="None">
  The ID or IDs of the session(s) for which you want to list evaluations.
</ResponseField>

<ResponseField name="version_id" type="str" default="None">
  The ID of the version for which you want to list evaluations.
</ResponseField>

<ResponseField name="test_case_id" type="str | list[str]" default="None">
  The ID or IDs of the test case(s) for which you want to list evaluations.
</ResponseField>

<ResponseField name="test_id" type="str | list[str]" default="None">
  The ID or IDs of the test(s) for which you want to list evaluations.
</ResponseField>

<ResponseField name="metric_id" type="str | list[str]" default="None">
  The ID or IDs of the metric(s) for which you want to list evaluations.
</ResponseField>

<ResponseField name="status" type="str | list[str]" default="None">
  Filter by evaluation status(es). Valid values are `'PENDING'`, `'PENDING_HUMAN'`, `'SUCCESS'`, `'FAILED'`, `'SKIPPED'`, `'CANCELLED'`. Other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.
</ResponseField>

<ResponseField name="from_created_at" type="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`.
</ResponseField>

<ResponseField name="to_created_at" type="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`.
</ResponseField>

<ResponseField name="sort_by_created_at" type="string" optional>
  Sort evaluations by creation date. Valid values are "asc" and "desc".
</ResponseField>

<ResponseField name="sort_by_score" type="string" optional>
  Sort evaluations by score. Valid values are "asc" and "desc".
</ResponseField>

<ResponseField name="offset" type="int" default="0" optional>
  Number of evaluations to skip before starting to collect results. Use for pagination.

  **Default:** `0` (start from the beginning)
</ResponseField>

<ResponseField name="limit" type="int" default="10000" optional>
  Maximum number of evaluations to return in a single request.

  **Default:** `10000`
</ResponseField>