For the complete documentation index, see llms.txt. This page is also available as Markdown.

GET /v2/evals/experiments/{experiment_id}/status

Get Eval Experiment Status

get

Read the latest job and current result counts and aggregates.

How to use

Use for latest-job overview and current counts/aggregates. For one accepted execution, poll its dedicated job URL so a later job does not change what you are observing.

Authentication and permissions

Required permissions: evals.read. Resource and owner access checks also apply.

Authorizations
AuthorizationstringRequired

Personal API key (sk_...) or supported user access JWT. See Authentication and authorization for endpoint restrictions and scopes. Use exactly one Authorization header.

Path parameters
experiment_idstring · uuidRequired
Responses
200

Successful Response

application/json
response_codestring · nullableOptional

Machine-readable response code, when provided.

get/v2/evals/experiments/{experiment_id}/status
curl
curl --fail-with-body -sS \
  "$STACKAI_BASE_URL/v2/evals/experiments/${EXPERIMENT_ID}/status" \
  -H "Authorization: Bearer $STACKAI_API_KEY"
{
  "response_code": "text",
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "data": {
    "latest_job": {
      "job_id": "123e4567-e89b-12d3-a456-426614174000",
      "experiment_id": "123e4567-e89b-12d3-a456-426614174000",
      "mode": "generate",
      "evaluator_ids": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "status": "queued",
      "created_at": "2026-01-01T00:00:00.000Z",
      "started_at": "2026-01-01T00:00:00.000Z",
      "finished_at": "2026-01-01T00:00:00.000Z",
      "last_activity_at": "2026-01-01T00:00:00.000Z",
      "error": {
        "code": "text",
        "message": "text"
      }
    },
    "job_status_available": true,
    "status_counts": {
      "pending": 1,
      "running": 1,
      "completed": 1,
      "failed": 1,
      "total": 1,
      "done": 1
    },
    "aggregate_cards": [
      {
        "evaluator_id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "aggregate": 1,
        "scored_count": 1,
        "judge_failed_count": 1,
        "has_scores": true,
        "segments": [
          {
            "label": "text",
            "count": 1,
            "value": 1
          }
        ]
      }
    ]
  }
}

Last updated

Was this helpful?