Skip to main content
GET
https://api.keywordsai.co
/
api
/
datasets
/
{dataset_id}
/
eval-reports
/
list
List eval runs
curl --request GET \
  --url https://api.keywordsai.co/api/datasets/{dataset_id}/eval-reports/list/ \
  --header 'Authorization: Bearer <token>'
{
  "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"
    }
  ]
}
List all evaluation reports (eval runs) for a specific dataset.

​
Authentication

  • API key: Authorization: Bearer <API key>

​
Path Parameters

​
dataset_id
string
required
The ID of the dataset to list evaluation reports for.

​
Examples

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())

​
Response

{
  "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"
    }
  ]
}