GET /v2/evals/experiments/{experiment_id}/status
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.
Personal API key (sk_...) or supported user access JWT. See Authentication and authorization for endpoint restrictions and scopes. Use exactly one Authorization header.
Successful Response
Machine-readable response code, when provided.
Invalid request or pagination cursor
Missing or invalid credentials
Denied permission, project folder access, or API-key scope (meta.required_scope)
Resource not found in the caller's organization
Job launch was rejected or job state is temporarily unavailable
Client error returned in the public API envelope
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?

