Retrieve all evaluations for the authenticated user.

This endpoint returns a paginated list of lean evaluation rows. Fetch GET /evaluations/{evaluation_id} for the full record and /results for scores.

Query Parameters:

• status (optional): Filter by evaluation status (QUEUED, PROCESSING, READY, FAILED)
• model_id (optional): Filter by specific model ID
• limit (optional): Number of evaluations to return (1-100, default: 10)
• offset (optional): Number of evaluations to skip for pagination (default: 0)

Returns:

• user_id: The authenticated user's ID
• evaluations: List of evaluation_id, evaluation_name, status, created_at
• total: Total number of evaluations matching the filters
• limit: Requested page size
• offset: Current pagination offset

Example Request:

GET /api/v3/evaluations/list?status=READY&limit=5&offset=0
Headers: {"Authorization": "Bearer <api_key>"}

Example Response:

{
  "user_id": "01KKBERWEEM634BQW9BK6Y0Y",
  "evaluations": [
    {
      "evaluation_id": "eval_01KKJHBNFY9STH1C9",
      "evaluation_name": "Clause Review v2 Eval",
      "status": "READY",
      "created_at": "2026-03-10T10:43:12.826791",
      "alignment_id": "alignment_01k4x9m2p7q3r8c1"
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}

{
  "user_id": "user-abc123",
  "evaluations": [
    {
      "evaluation_id": "evaluation_01k4x9m2p7q3r7b1",
      "evaluation_name": "Clause Review v2 Eval",
      "alignment_id": "alignment_01k4x9m2p7q3r8c1",
      "results": {
        "baseline_metrics": {
          "binary_correctness_mean": 0.85,
          "response_relevance_mean": 0.8
        },
        "baseline_model_id": "model_01kabc456r",
        "comparison": {
          "metrics_relative": {
            "binary_correctness_mean": 0.07,
            "response_relevance_mean": 0.08
          }
        },
        "metrics": {
          "binary_correctness_mean": 0.92,
          "response_relevance_mean": 0.88
        },
        "model_id": "model_01kmqm4nrn9fw6r"
      }
    }
  ],
  "total": 5,
  "limit": 10
}