Skip to main content
GET
Read research status

Authorizations

Authorization
string
header
required

Workspace API key created while signed in on the Developers page. Send Authorization: Bearer seneca_sk_… A Clerk session token is not accepted.

Path Parameters

run_id
string<uuid>
required

Response

Current run, including credits_reserved, credits_charged, and progress.

id
string<uuid>
required
status
string
required

queued, running, synthesizing, completed, partial, or failed.

prompt
string
required
credits_reserved
integer
required

Credits reserved when the run was accepted. This is the panel price and does not change if the run is later refunded.

created_at
string<date-time>
required
progress
PublicProgressOut · object
required
object
string
default:research.run
Allowed value: "research.run"
phase
string | null

panel while models are still answering. Null while synthesizing or after the run finishes.

source
string | null
panel
string | null

Canonical panel id: wide, consensus, or seneca. A stored Quick Pulse run still reports quick_pulse.

credits_charged
integer | null

Null while the run is in progress. Equal to credits_reserved when a customer report is delivered, including a partial run that has a report. 0 after a verified technical failure with no customer report; that refund restores the reserve. failure_code does not change between a charged failure and a refunded one.

failure_code
string | null

research_failed when status is failed. Null otherwise.

completed_at
string<date-time> | null