List eval runs
List all evaluation reports (eval runs) for a specific dataset.
## Authentication
- API key: `Authorization: Bearer `
## Path Parameters
- `dataset_id` *string* **required**: The ID of the dataset to list evaluation reports for.
## Examples
```python Python
dataset_id = "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a"
url = f"https://api.respan.ai/api/datasets/{dataset_id}/eval-reports/list/"
headers = {
"Authorization": "Bearer YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
```
```bash cURL
curl -X GET "https://api.respan.ai/api/datasets/{dataset_id}/eval-reports/list/" \
-H "Authorization: Bearer YOUR_API_KEY"
```
## Response
```json 200 OK
{
"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"
}
]
}
```
Authentication
AuthorizationBearer
API key authentication. Get your API key from https://platform.respan.ai/platform/api-keys
Path parameters
dataset_id
The ID of the dataset to list evaluation reports for.
Response
Successful response for List eval runs
Errors
401
Unauthorized Error
