Get the current status of an evaluation.

This endpoint retrieves the status of a running or completed evaluation. Use this to determine when results are ready; fetch the full record once from GET /evaluations/{evaluation_id}.

Path Parameters:

• evaluation_id: Unique evaluation identifier

Returns:

• evaluation_id: The evaluation identifier
• status: Current status (QUEUED, PROCESSING, READY, FAILED)
• created_at, completed_at, updated_at: timestamps
• progress, eta_seconds: not wired up yet, always null
• error: why the evaluation failed, set only when status is FAILED

Raises:

• 404: If evaluation not found or doesn't belong to the authenticated user

Example Request:

GET /api/v3/evaluations/evaluation_01k4x9m2p7q3r7b1/status
Headers: {"Authorization": "Bearer <api_key>"}

Example Response:

{
  "evaluation_id": "evaluation_01k4x9m2p7q3r7b1",
  "status": "READY",
  "created_at": "2024-02-24T10:00:00Z",
  "completed_at": "2024-02-24T10:05:00Z",
  "updated_at": "2024-02-24T10:05:00Z",
  "progress": null,
  "eta_seconds": null
}

Notes:

• Once status is READY, use /evaluations/{evaluation_id}/results to get full results
• Status FAILED indicates an error occurred during evaluation

{
  "evaluation_id": "evaluation_01k4x9m2p7q3r7b1",
  "created_at": "2024-02-24T10:00:00Z",
  "completed_at": "2024-02-24T10:05:00Z",
  "error": "Inference server rejected the batch: model not found"
}