> ## 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. # 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. ## OpenAPI ````yaml /openapi_specs/models.json get /v1/workflows/{workflowID}/executions openapi: 3.0.3 info: title: each::labs Official API v1 description: > Official each::labs API V1. This API provides access to our comprehensive AI model catalog and other resources. ## Public contract notes - Public API routes handled by request logging include `X-Request-Id` for support and log correlation. Clients may send `X-Request-Id`; otherwise api-service generates one. Root, health, and metrics endpoints are excluded. - REST error bodies keep the backward-compatible JSON shape used by existing clients. Most errors include at least `error`; some shared error paths also include `status` and `details`. Use the HTTP status code as the primary programmatic signal unless an endpoint documents a richer envelope. - Rate-limit and retry headers are endpoint-dependent. If a response includes `Retry-After`, honor it before retrying; otherwise use bounded exponential backoff for retryable 429/5xx responses. version: 1.0.0 contact: name: API Support email: support@eachlabs.ai x-logo: url: ./logo-white.svg altText: each::labs servers: - url: https://api.eachlabs.ai description: Production server security: [] tags: - name: AI Models description: Endpoints for listing and retrieving AI models and other resources. - name: AI Models Prediction description: Endpoints for managing model predictions - name: Uploads description: Endpoints for uploading files that can be used as model inputs. - name: Executions description: Endpoints for listing execution history. - name: Workflows description: >- Endpoints for creating workflows and triggering workflow executions through api-service. - name: OpenAI Compatibility description: OpenAI-compatible endpoints for LLM Router requests. - name: Webhooks description: > Endpoints for retrieving webhook information and delivery history. **Note:** Currently, webhooks are only supported for Workflows V2. We are actively expanding webhook support to other services and will update this documentation as new integrations become available. paths: /v1/workflows/{workflowID}/executions: get: tags: - Executions summary: List workflow executions description: > 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. operationId: listWorkflowExecutions parameters: - name: workflowID in: path required: true schema: type: string description: Workflow ID or slug. example: wf_abc123 - name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 50 description: Maximum number of executions to return per page. example: 50 - name: offset in: query schema: type: integer default: 0 minimum: 0 description: Number of executions to skip for pagination. example: 0 - name: bulk_id in: query schema: type: string format: uuid description: >- Optional filter: only return executions queued by this bulk trigger operation. The `bulk_id` is returned by the bulk trigger endpoint. example: 550e8400-e29b-41d4-a716-446655440000 responses: '200': description: List of workflow executions content: application/json: schema: $ref: '#/components/schemas/WorkflowExecutionsListResponse' example: executions: - execution_id: exec-1 flow_id: wf-123 flow_name: Text to Image Generator version_id: v1 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' - execution_id: exec-2 flow_id: wf-123 flow_name: Text to Image Generator version_id: v1 status: running started_at: '2026-01-01T10:10:00Z' created_at: '2026-01-01T10:10:00Z' updated_at: '2026-01-01T10:10:00Z' limit: 50 total_count: 142 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' security: - BearerAuth: [] components: schemas: WorkflowExecutionsListResponse: type: object description: Paginated list of workflow executions required: - executions - limit - total_count properties: executions: type: array description: Array of execution summaries items: $ref: '#/components/schemas/WorkflowExecutionSummary' limit: type: integer description: Applied page size example: 50 total_count: type: integer description: Total number of executions matching the query example: 142 WorkflowExecutionSummary: type: object description: Summary of one workflow execution, as returned by the list endpoint. required: - execution_id - flow_id - flow_name - version_id - status - created_at properties: execution_id: type: string description: Unique execution identifier example: exec-1 flow_id: type: string description: Workflow identifier (UUID) example: wf-123 flow_name: type: string description: Human-readable workflow name example: Text to Image Generator version_id: type: string description: Version identifier for this execution example: v1 api_key: type: string description: User/API key identifier that triggered this execution example: user-456 status: type: string enum: - running - completed - failed - cancelled description: Current execution status example: completed started_at: type: string format: date-time description: >- RFC3339 timestamp when the execution started (omitted if not started yet) example: '2026-01-01T10:00:00Z' ended_at: type: string format: date-time description: >- RFC3339 timestamp when the execution completed (omitted for running executions) example: '2026-01-01T10:05:00Z' created_at: type: string format: date-time description: RFC3339 timestamp when the execution was created example: '2026-01-01T10:00:00Z' updated_at: type: string format: date-time description: RFC3339 timestamp when the execution was last updated example: '2026-01-01T10:05:00Z' deleted_at: type: string format: date-time description: >- RFC3339 timestamp when the execution was soft-deleted (if applicable) inputs: type: object additionalProperties: true description: Input parameters provided when triggering the workflow example: prompt: Generate an image of a sunset step_results: description: >- Brief summary of step execution results. Structure varies — may be an object with step IDs as keys, or an array. oneOf: - type: object - type: array items: {} output: type: string description: >- Simple string output from the workflow (if available). For complex outputs, use `output_json` instead. example: https://storage.googleapis.com/uploads/image.png output_json: type: object additionalProperties: true description: >- Structured JSON output from the workflow (if available). Contains the full workflow output when output mapping is configured. example: image_url: https://storage.googleapis.com/uploads/image.png generation_time: 2.45 cost: description: >- Cost information for this execution (if available). Structure varies by provider and workflow configuration. oneOf: - type: object - type: number Error: type: object description: > Backward-compatible REST error body. Endpoint-specific handlers may return only `error`; shared error paths may also include `status` and `details`. properties: status: type: integer description: HTTP status code, when returned by the shared error handler. example: 400 error: type: string description: Safe user-facing error message. example: error message details: nullable: true description: Optional validation or request details for client errors. required: - error responses: BadRequest: description: Bad request headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: slug parameter is required Unauthorized: description: Authentication required or invalid credentials headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Invalid or missing API key NotFound: description: Resource not found headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: 'Failed to fetch model: model not found' InternalServerError: description: Internal server error headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: 'Failed to fetch models: internal error' headers: RequestId: description: >- Request correlation ID. Echoes the incoming `X-Request-Id` header or a generated ID. schema: type: string example: 123e4567-e89b-12d3-a456-426614174000 securitySchemes: BearerAuth: type: http scheme: bearer description: >- API key passed as an Authorization Bearer token: `Authorization: Bearer YOUR_API_KEY` ````