89261af4dd80
List Flow Runs
Retrieves a paginated list of flow runs. Can be filtered by user_id, flow_id, flow_version_id, virtual_environment_id, trigger, status, date range, and other criteria.
Query parameters
Filter results by user_id.
Filter results by flow_id.
Filter results by flow_version_id.
Filter results by virtual_environment_id.
Filter results by trigger.
Filter results by status.
Filter results by search.
Filter results to flow runs that started before the specified time. Accepts a Unix timestamp in milliseconds, e.g. 2026-03-01 19:00 converts to 1772391627000 so 1772391627000 is the parameter value.
Filter results to flow runs that started after the specified time. Accepts a Unix timestamp in milliseconds.
Filter results to flow runs that started on the specified date. Accepts a Unix timestamp in milliseconds.
Filter results by retried.
Filter results by has_warnings.
Comma-separated list of relationships to include. Available: flowVersion, flowVersion.steps, flow, flowRunLogs, errorWarningLogs, flowRunLogs.flowStep, trackedData, metrics, cpuTime, payloadSize, operationsSent, operationsReceived, retriedFlowRun, virtualEnvironmentVersion, virtualEnvironmentVersion.virtualEnvironment
Sort field. Prefix with - for descending. Available: started_at
Comma-separated list of trackedData fields to return. Available: id
Comma-separated list of flow fields to return. Available: id, name
Comma-separated list of flowVersion fields to return. Available: steps.name
Comma-separated list of retriedFlowRun fields to return. Available: id, status
Page number for pagination.
Number of results per page.
Response
Successful response