List span scores
Retrieves all scores associated with a specific log.
```Python Python
url = "https://api.respan.ai/api/logs/{log_id}/scores/"
api_key = "YOUR_KEY" # Replace with your actual Respan API key
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
print(response.json())
```
```json 200 OK
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": "eval_result_unique_id_1",
"created_at": "2024-01-15T10:30:00Z",
"type": "llm",
"environment": "test",
"numerical_value": 4.5,
"string_value": "Good quality",
"boolean_value": true,
"categorical_value": ["excellent"],
"is_passed": false,
"cost": 0.0,
"evaluator_id": null,
"evaluator_slug": "quality_evaluator",
"log_id": "log_unique_id",
"dataset_id": null
}
]
}
```
## Score Enrichment in Spans
When you retrieve span details, scores are automatically included in the response under a `scores` field with enriched information including evaluator names and score values.
## Score Summary Aggregations
Aggregated score summaries (average scores for numerical evaluators, true/false counts for boolean evaluators) are available in:
- **Spans Summary**: [GET/POST /api/request-logs/summary/](/api-reference/observe/logs/get-spans-summary)
- **Experiment Spans Summary**: GET/POST /evaluations/experiments/{experiment_id}/logs/summary/
- **Dataset Spans Summary**: GET/POST /api/datasets/{dataset_id}/logs/summary/
Score summaries show:
- **Numerical/Percentage evaluators**: Average score (1-5 scale or 0-100%)
- **Boolean evaluators**: True count and false count
See the [Spans Summary endpoint](/api-reference/observe/logs/get-spans-summary) for complete details on the score summary format.
Authentication
AuthorizationBearer
API key authentication. Get your API key from https://platform.respan.ai/platform/api-keys
Path parameters
log_id
Log Id
Response
Successful response for List span scores
Errors
401
Unauthorized Error