Retrieve span score

Gets detailed information about a specific score for a log. ```Python Python url = "https://api.respan.ai/api/logs/{log_id}/scores/{score_id}/" 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 { "id": "eval_result_unique_id", "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. This enriched format includes: - **evaluator_name**: Human-readable name of the evaluator - **evaluator_slug**: URL-friendly identifier - **score_value**: The actual score value (numerical, boolean, etc.) Example enriched scores in a span response: ```json { "id": "log_abc123", "model": "gpt-4", "scores": { "550e8400-e29b-41d4-a716-446655440000": { "evaluator_name": "Response Quality", "evaluator_slug": "quality_v1", "score_value": 4.5 } } } ``` ## Score Summary Aggregations Aggregated score summaries are available in summary endpoints. These show average scores for numerical evaluators and true/false counts for boolean evaluators: - **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/ 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_idstringRequired
Log Id
score_idstringRequired
Score Id

Response

Successful response for Retrieve span score
idstring
modelstring
scoresobject

Errors

401
Unauthorized Error