Executions

List workflow executions

Retrieve a paginated list of executions for a specific workflow.

When a bulk_id query parameter is provided, only executions queued by that bulk trigger operation are returned. Pagination applies with the same limit and offset parameters.

get/v1/workflows/{workflowID}/executions

Request

  • Base URL: https://api.eachlabs.ai
  • URL: https://api.eachlabs.ai/v1/workflows/{workflowID}/executions
  • Auth: HTTP bearer

Path parameters

workflowIDstring required

Workflow ID or slug.

Query parameters

limitinteger

Maximum number of executions to return per page.

offsetinteger

Number of executions to skip for pagination.

bulk_idstring uuid

Optional filter: only return executions queued by this bulk trigger operation. The bulk_id is returned by the bulk trigger endpoint.

Response

List of workflow executions

limitinteger required

Applied page size

total_countinteger required

Total number of executions matching the query

Example response

{
  "executions": [
    {
      "execution_id": "exec-1",
      "flow_id": "wf-123",
      "flow_name": "Text to Image Generator",
      "version_id": "v1",
      "api_key": "user-456",
      "status": "completed",
      "started_at": "2026-01-01T10:00:00Z",
      "ended_at": "2026-01-01T10:05:00Z",
      "created_at": "2026-01-01T10:00:00Z",
      "updated_at": "2026-01-01T10:05:00Z",
      "inputs": {
        "prompt": "Generate an image of a sunset"
      },
      "output": "https://storage.googleapis.com/uploads/image.png",
      "output_json": {
        "image_url": "https://storage.googleapis.com/uploads/image.png",
        "generation_time": 2.45
      }
    }
  ],
  "limit": 50,
  "total_count": 142
}

Changes

No recorded changes to this operation across all 1 revision of this API.