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

# List eval runs

List all evaluation reports (eval runs) for a specific dataset.

## Authentication

* API key: `Authorization: Bearer <API key>`

## Path Parameters

<ParamField path="dataset_id" type="string" required>
  The ID of the dataset to list evaluation reports for.
</ParamField>

## Examples

<CodeGroup>
  ```python Python theme={"system"}
  import requests

  dataset_id = "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a"
  url = f"https://api.keywordsai.co/api/datasets/{dataset_id}/eval-reports/list/"
  headers = {
      "Authorization": "Bearer YOUR_API_KEY"
  }

  response = requests.get(url, headers=headers)
  print(response.json())
  ```

  ```bash cURL theme={"system"}
  curl -X GET "https://api.keywordsai.co/api/datasets/{dataset_id}/eval-reports/list/" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</CodeGroup>

## Response

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "count": 2,
    "results": [
      {
        "id": "report_id_123",
        "dataset_id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
        "status": "completed",
        "evaluator_slugs": ["char_count_eval"],
        "created_at": "2025-07-26T00:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>