Skip to main content
GET
/
workflows
/
{workflowID}
/
executions
List workflow executions
curl --request GET \
  --url https://workflows.eachlabs.run/api/v1/workflows/{workflowID}/executions \
  --header 'X-API-Key: <api-key>'
{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://docs.eachlabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Path Parameters

​
workflowID
string
required

Unique workflow identifier

Example:

"wf_abc123"

Query Parameters

​
bulk_id
string<uuid>

Optional: Filter executions by bulk operation ID.

When provided, only returns executions from the specified bulk trigger operation. The bulk_id is returned when you trigger a workflow via the bulk-trigger endpoint.

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
offset
integer<int32>
default:0

Pagination offset - number of items to skip.

The response includes a offset field pointing to the next page if more results exist.

Required range: x >= 0
Example:

0

​
limit
integer<int32>
default:50

Maximum number of executions to return per page.

Default: 50 Maximum: 100

Required range: 1 <= x <= 100
Example:

50

Response

List of workflow executions

Paginated list of workflow executions

​
executions
object[]
required

Array of execution summaries

​
total_count
integer<int32>
required

Total number of executions matching the query

Example:

142

​
offset
integer<int32>

Offset for the next page of results.

If null, there are no more results to fetch.

Example:

50

Last modified on May 28, 2026