> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # List Executions > Use this endpoint to retrieve a paginated list of workflow executions. You can filter results by workflow ID or status. ## OpenAPI ````yaml /en/openapi/v3-current/flowker.yaml get /v1/executions openapi: 3.1.0 info: description: >- Complete API reference for Flowker workflow orchestration services including catalog management, workflow definitions, executor configurations, provider configurations, and workflow executions. title: Flowker API version: 1.1.0 servers: - url: https://flowker.sandbox.lerian.net security: - ApiKeyAuth: [] tags: - name: Health API description: Health and version endpoints for monitoring the Flowker service. - name: Catalog API description: >- Browse built-in providers, executors, and triggers available in the Flowker catalog. - name: Workflows API description: >- Create, update, activate, deactivate, clone, and delete workflow definitions. - name: Executions API description: Start workflow executions and track their status and results. - name: Executor Configurations API description: >- Configure, test, and manage external executor connections used by workflow nodes. - name: Provider Configurations API description: Configure, test, enable, and disable provider integrations. - name: Dashboard API description: >- Retrieve aggregated summaries of workflows and executions for operational dashboards. - name: Audit API description: Query and verify audit events for compliance and operational visibility. - name: Webhooks API description: >- Receive webhook callbacks from external systems to trigger workflow executions. paths: /v1/executions: get: tags: - Executions API summary: List Executions description: >- Use this endpoint to retrieve a paginated list of workflow executions. You can filter results by workflow ID or status. operationId: listExecutions parameters: - description: Filter results by a specific workflow ID. in: query name: workflowId schema: format: uuid type: string - description: Filter results by status. in: query name: status schema: enum: - pending - running - completed - failed type: string - description: >- Maximum number of items to return per page. Defaults to 10. Must be between 1 and 100. in: query name: limit schema: default: 10 maximum: 100 minimum: 1 type: integer - description: >- Cursor for pagination. Use the value from the `nextCursor` field in a previous response to retrieve the next page. in: query name: cursor schema: type: string - description: Field to sort results by. in: query name: sortBy schema: default: startedAt enum: - startedAt - completedAt type: string - description: Sort direction. Use `ASC` for ascending or `DESC` for descending. in: query name: sortOrder schema: default: DESC enum: - ASC - DESC type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExecutionListOutput' description: >- Indicates that the request was successful and the response contains the requested data. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indicates that the request was malformed or contained invalid parameters. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indicates an unexpected internal error. If this persists, please contact support. components: schemas: ExecutionListOutput: example: items: - executionId: f7e6d5c4-b3a2-1098-7654-321fedcba098 workflowId: a1b2c3d4-e5f6-7890-abcd-ef1234567890 status: completed currentStepNumber: 1 totalSteps: 1 startedAt: '2026-03-17T14:35:00Z' completedAt: '2026-03-17T14:35:00Z' nextCursor: '' hasMore: false properties: hasMore: description: Indicates whether more pages are available. example: false type: boolean items: description: List of execution statuses in the current page. items: $ref: '#/components/schemas/ExecutionStatusOutput' type: array nextCursor: description: Cursor for the next page. example: '' type: string type: object ErrorResponse: properties: code: description: Machine-readable error code with the FLK prefix. example: FLK-0001 type: string message: description: Human-readable explanation of the error. example: Invalid input provided type: string title: description: Short error category title. example: Bad Request type: string required: - code - message - title type: object ExecutionStatusOutput: properties: completedAt: description: Timestamp when the execution finished. Null if still running. example: '2026-03-17T14:35:12Z' format: date-time type: string currentStepNumber: description: Number of the step currently being executed (1-indexed). example: 1 type: integer errorMessage: description: Error message if the execution failed. Null on success. type: string executionId: description: Unique identifier of the execution. example: f7e6d5c4-b3a2-1098-7654-321fedcba098 format: uuid type: string startedAt: description: Timestamp when the execution started. example: '2026-03-17T14:35:00Z' format: date-time type: string status: description: >- Current status: `pending` (queued), `running` (in progress), `completed` (success), or `failed` (error). enum: - pending - running - completed - failed example: completed type: string totalSteps: description: Total number of steps in the workflow. example: 1 type: integer workflowId: description: ID of the workflow being executed. example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 format: uuid type: string type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- API key for authenticating requests to the Flowker API. Provisioned via the API_KEY environment variable during deployment. ````