API Referencev2 API (Current)Workflows

Get Execution State

Get workflow execution state with steps for live UI polling.

This endpoint returns the current state of a workflow execution including all steps with their details. It’s designed to be polled every 2 seconds during execution to show real-time progress in the frontend.

Authentication

X-Browser-Use-API-Keystring
API Key authentication via header

Path Parameters

execution_idstringRequiredformat: "uuid"

Response

Successful Response
idstringformat: "uuid"
Unique identifier for the execution
workflowIdstringformat: "uuid"
ID of the workflow being executed
statusenum
Current status of the execution
Allowed values:
createdAtdatetime
When execution was created
startedAtdatetime or null
When execution started
finishedAtdatetime or null
When execution finished
stepslist of objects or null
List of execution steps with details
llmsCoststring or nullformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"Defaults to 0
LLM costs for this execution
initCoststring or nullformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"Defaults to 0
Initialization costs
totalCoststring or nullformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"Defaults to 0
Total cost
liveUrlstring or null

Live browser view URL (available during and up to 60s after execution)

Errors