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

# List evaluations

> Page through evaluation history and filter by status or video.

The list endpoint returns evaluations newest first. Use `limit` and `offset` for a specific page. Filter with `video_id` or one or more statuses.

<Tabs>
  <Tab title="TypeScript">
    ```ts theme={null}
    const page = await galileo.evaluations.list({
      limit: 20,
      offset: 0,
      status: ["completed", "partial"],
    });

    for await (const evaluation of galileo.evaluations.iterate({
      status: ["failed"],
    })) {
      console.log(evaluation.id);
    }
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    page = galileo.evaluations.list(
        limit=20,
        offset=0,
        status=["completed", "partial"],
    )

    for evaluation in galileo.evaluations.iterate(status=["failed"]):
        print(evaluation.id)
    ```
  </Tab>
</Tabs>

`iterate` requests each page as needed and yields one evaluation at a time. It uses the response counts to stop at the end of the selected statuses.