Skip to main content
GET
Get Prompt Run Status

Authorizations

X-Lightsage-Api-Key
string
header
required

Path Parameters

run_id
string
required

Run ID returned by POST /v2/prompts/runs, not a stored prompt result ID.

Response

Successful Response

id
string
required

Run ID to poll with GET /v2/prompts/runs/{run_id}/status.

job_id
string
required

Parent job ID. It currently matches id.

type
string
required
Allowed value: "prompts"
source_type
string
required
Allowed value: "prompts"
status
required

Terminal values: completed, failed, and cancelled. Recoverable interruptions are reported as running with stage retrying.

Available options:
pending,
running,
summarizing,
completed,
failed,
cancelled,
interrupted
stage
string | null

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

dispatch_id
string | null
progress
PublicEvalRunProgress · object
estimated_cost
number | null

The estimated credit cost for prompt jobs or estimated USD cost for API Performance jobs. Null when no estimate is available.

eval_count
integer | null
model_count
integer | null
error
string | null
created_at
string | null
started_at
string | null
completed_at
string | null

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