Skip to main content
GET
Get research run by ID

Authorizations

X-API-Key
string
header
required

API key for authentication. Get your key from the API Keys page.

Path Parameters

research_run_id
string
required

Research run identifier

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Response

Research run

research_run_id
string
required

Unique research run identifier

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

status
enum<string>
required

Current status of the research run

Available options:
RUNNING,
COMPLETED,
FAILED,
CANCELLED,
TIMED_OUT
Example:

"COMPLETED"

query
string
required

The research query

Example:

"What are the latest AI safety papers?"

quick_result
object | null
required

Quick answer with citations, available before deep research completes

quick_result_summary
string | null
required

Short prose summary of the quick result

deep_result
object | null
required

Deep research report, available after the run completes

run_ids
string[]
required

IDs of the agent runs spawned by this research run

Example:
created_at
string | null
required

ISO 8601 timestamp when the research run was created

Example:

"2026-01-01T12:00:00Z"

completed_at
string | null
required

ISO 8601 timestamp when the research run completed, or null if still running

Example:

"2026-01-01T12:05:00Z"

research_plan
object | null
required

Subquestions and searches the run planned

evidence
object[] | null
required

Sources gathered, with the claims they support

iterations
integer | null
required

Number of plan-search-synthesize iterations the run completed

Required range: x >= 0
Example:

3