List scores | Respan Docs

curl https://api.respan.ai/api/scores/ \
     -H "Authorization: Bearer sk_live_xxxxx" \
     -H "Content-Type: application/json"

{
  "count": 2,
  "results": [
    {
      "id": "score_550e8400",
      "created_at": "2024-01-15T09:30:00Z",
      "type": "llm",
      "environment": "production",
      "numerical_value": 4.5,
      "string_value": "Good response quality",
      "boolean_value": true,
      "categorical_value": [
        "excellent"
      ],
      "json_value": "{\"rating\": 5, \"reason\": \"Accurate\"}",
      "is_passed": true,
      "cost": 0.02,
      "evaluator_id": "evl_550e8400",
      "evaluator_slug": "response_quality",
      "evaluator_name": "Response Quality",
      "scorer": "marcus@example.com",
      "log_id": "log_abc123",
      "prompt_id": "prompt_12345",
      "prompt_version_number": 3,
      "dataset_id": "dataset_98765",
      "automation_id": "auto_45678",
      "status": "completed",
      "error_message": null
    },
    {
      "id": "score_550e8401",
      "created_at": "2024-01-15T09:45:00Z",
      "type": "human_boolean",
      "environment": "staging",
      "numerical_value": null,
      "string_value": null,
      "boolean_value": false,
      "categorical_value": null,
      "json_value": null,
      "is_passed": false,
      "cost": 0,
      "evaluator_id": "evl_550e8401",
      "evaluator_slug": "human_feedback",
      "evaluator_name": "Human Feedback",
      "scorer": "jane.doe@example.com",
      "log_id": "log_def456",
      "prompt_id": "prompt_12346",
      "prompt_version_number": 1,
      "dataset_id": "dataset_98766",
      "automation_id": null,
      "status": "completed",
      "error_message": null
    }
  ],
  "next": "https://api.respan.ai/api/scores/?page=2&page_size=2",
  "previous": null,
  "current_filters": {}
}

List evaluation scores with pagination. For complex filters, use POST /api/scores/list/.

Query parameters

pageintegerOptional>=1

Page number.

page_sizeintegerOptional1-100

Number of results to return per page. Maximum 100.

start_timedatetimeOptional

Filter scores created at or after this timestamp.

end_timedatetimeOptional

Filter scores created before this timestamp.

Response

Paginated list of scores.

countinteger

Number of scores returned on this page.

resultslist of objects

nextstring or null

URL for the next page, if any.

previousstring or null

URL for the previous page, if any.

current_filtersobject

Normalized filters applied to this request.

Errors

401

Unauthorized Error

Headers

Query parameters

Response

Errors