Skip to main content

​
Endpoint

GET https://workflows.eachlabs.run/api/v1/workflows/{workflowID}/executions

​
Path Parameters

ParameterTypeRequiredDescription
workflowIDstringYesWorkflow UUID or slug

​
Query Parameters

ParameterTypeRequiredDefaultDescription
bulk_idstring (UUID)No-Filter by bulk operation ID
offsetintegerNo0Number of items to skip
limitintegerNo50Max results per page (1–100)

​
Code Examples

# List all executions
curl "https://workflows.eachlabs.run/api/v1/workflows/WF_ID/executions?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

# Filter by bulk ID
curl "https://workflows.eachlabs.run/api/v1/workflows/WF_ID/executions?bulk_id=BULK_ID" \
  -H "X-API-Key: YOUR_API_KEY"

​
Response

{
  "executions": [
    {
      "execution_id": "exec-1",
      "flow_id": "wf-123",
      "flow_name": "Text to Image Generator",
      "version_id": "v1",
      "status": "completed",
      "started_at": "2025-12-20T10:00:00Z",
      "ended_at": "2025-12-20T10:05:00Z",
      "created_at": "2025-12-20T10:00:00Z",
      "updated_at": "2025-12-20T10:05:00Z"
    },
    {
      "execution_id": "exec-2",
      "flow_id": "wf-123",
      "flow_name": "Text to Image Generator",
      "version_id": "v1",
      "status": "running",
      "started_at": "2025-12-20T10:10:00Z",
      "created_at": "2025-12-20T10:10:00Z",
      "updated_at": "2025-12-20T10:10:00Z"
    }
  ],
  "offset": 2,
  "total_count": 142
}

​
Execution Summary Fields

FieldTypeDescription
execution_idstringUnique execution ID
flow_idstringWorkflow UUID
flow_namestringWorkflow name
version_idstringVersion used
statusstringrunning, completed, failed, or cancelled
started_atstringWhen execution started
ended_atstring | nullWhen execution ended
total_countintegerTotal matching executions

​
Error Responses

StatusBodyDescription
400{"error": "invalid bulk_id format"}Invalid UUID format
401{"error": "Invalid or missing API key"}Authentication failure
404{"error": "workflow not found"}Invalid workflow ID
Last modified on March 6, 2026