USusesapient
Eval Jobs

Poll Eval Job

Returns the status and progress of a durable eval job.

The eval_run_id is the id returned by POST /v1/eval-runs. Progress is computed from the parent job, its dispatch, and child jobs. Poll this endpoint until status reaches a terminal value.

get/v1/eval-runs/{eval_run_id}

Request

  • Base URL
    https://api.lightsage.com
  • Auth
    API key in header X-Lightsage-Api-Key

Path parameters

eval_run_idstring required

The ID returned by POST /v1/eval-runs, not a result ID from GET /v1/api-performance/runs.

Response

Successful Response

idstring required

Job ID for polling; not a result ID from GET /v1/api-performance/runs.

job_idstring required

The parent job ID. It currently contains the same polling ID as id.

type'prompts' | 'api_performance' required
source_type'prompts' | 'rest_api' | 'sdk' | 'cli' | 'custom_evals' required
stagestring nullable

Current lifecycle stage, including retrying while interrupted child jobs wait to be reclaimed.

dispatch_idstring nullable
estimated_costnumber nullable

Estimated credits for the run, worked out when it was queued. Credits actually used can differ by agent and model. Null when no estimate is available.

eval_countinteger nullable
model_countinteger nullable
errorstring nullable
created_atstring nullable
started_atstring nullable
completed_atstring nullable

Can be set while status is still summarizing; use status to detect completion.

Changes

No operation changes recorded.