Skip to main content
GET
/
sessions
/
{session_id}
/
runs
/
{run_id}
Get Run by ID
curl --request GET \
  --url https://api.example.com/sessions/{session_id}/runs/{run_id} \
  --header 'Authorization: Bearer <token>'
{
  "run_id": "fcdf50f0-7c32-4593-b2ef-68a558774340",
  "parent_run_id": "80056af0-c7a5-4d69-b6a2-c3eba9f040e0",
  "agent_id": "basic-agent",
  "user_id": "user_123",
  "run_input": "Which tools do you have access to?",
  "content": "I don't have access to external tools.",
  "created_at": 1728499200
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
session_id
string
required

Session ID to get run from

​
run_id
string
required

Run ID to retrieve

Query Parameters

​
type
enum<string>
default:agent

Session type (agent, team, or workflow)

Available options:
agent,
team,
workflow
​
user_id
string | null

User ID to query run from

​
db_id
string | null

Database ID to query run from

Response

Run retrieved successfully

​
run_id
string
required
​
parent_run_id
string | null
required
​
agent_id
string | null
required
​
user_id
string | null
required
​
run_input
string | null
required
​
content
required
​
run_response_format
string | null
required
​
reasoning_content
string | null
required
​
reasoning_steps
Reasoning Steps · object[] | null
required
​
metrics
Metrics · object
required
​
messages
Messages · object[] | null
required
​
tools
Tools · object[] | null
required
​
events
Events · object[] | null
required
​
created_at
string<date-time> | null
required
​
references
References · object[] | null
required
​
reasoning_messages
Reasoning Messages · object[] | null
required
​
images
Images · object[] | null
required
​
videos
Videos · object[] | null
required
​
audio
Audio · object[] | null
required
​
files
Files · object[] | null
required
​
response_audio
Response Audio · object
required
​
input_media
Input Media · object
required