> ## Documentation Index > Fetch the complete documentation index at: https://docs.flowra.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get workflow executions list > List past runs of your workflows with filters (status, date range, workflow ID) and pagination. Use to monitor runs and find a specific execution. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/workflow/manager/executions openapi: 3.0.0 info: title: Flowra API (API Key Endpoints) description: >- **Flowra** is an AI-powered platform for building agents, workflows, and integrations. ### Capabilities - **Tools & Toolkits** – Define and group tools for agents and workflows. - **Workflows** – Orchestrate steps and automate processes. - **Triggers** – Schedule or event-based execution. - **Auth & Connections** – OAuth, API keys, and connected accounts. - **MCP** – Model Context Protocol server integration. - **Knowledge / RAG** – Add files and URLs for retrieval-augmented generation. ### Authentication Use the **x-api-key** header with a project API key to access endpoints that support API Key auth. Create and manage API keys in the dashboard under your project settings. Only endpoints that support API Key authentication via the @ApiKeyEnabled() decorator. Send x-api-key (required). On multi-tenant endpoints, optionally send x-username to act as an external user. version: '1.0' contact: name: Flowra url: https://flowra.dev servers: - url: https://flowra.dev description: Flowra API security: [] tags: - name: Users description: User profile - name: External Users description: End-user identities inside a project (x-username) - name: Auth Configs description: OAuth and API key configs for toolkits - name: Connected Accounts description: OAuth connected accounts and link creation - name: Toolkits description: List and search toolkits - name: Tools description: List, execute, and manage tools - name: Skills description: Browse, create, import, and install skills - name: Workflow & Agent description: Create, run, and inspect workflows and agents - name: Triggers description: Schedule and event-based trigger instances - name: Chat description: Threads and streaming agent runs - name: File description: Upload, list, and download files - name: Knowledge description: RAG knowledge collections - name: Table description: Collections and documents - name: Sandbox description: Ephemeral and durable code sandboxes - name: Browser description: Live browser sessions and view - name: LLM description: List AI models and generate completions - name: MCP description: MCP server management - name: usage description: Credit balance and usage ledger for the project API key paths: /api/v1/workflow/manager/executions: get: tags: - Workflow & Agent summary: Get workflow executions list description: >- List past runs of your workflows with filters (status, date range, workflow ID) and pagination. Use to monitor runs and find a specific execution. operationId: WorkflowManagerController_getExecutions parameters: - name: q required: false in: query description: Search keyword for filtering results schema: example: john doe type: string - name: page required: false in: query description: Page number (1-based) schema: minimum: 1 default: 1 example: 1 type: number - name: limit required: false in: query description: Number of items per page schema: minimum: 1 maximum: 100 default: 20 example: 20 type: number - name: offset required: false in: query description: Number of items to skip (for offset-based pagination) schema: minimum: 0 example: 0 type: number - name: sortBy required: false in: query description: Field name to sort by schema: example: createdAt type: string - name: sortOrder required: false in: query description: Sort order schema: default: DESC example: DESC enum: - ASC - DESC type: string - name: fields required: false in: query description: Comma-separated list of fields to include in response schema: example: id,name,email type: string - name: workflowId required: false in: query description: Workflow ID to filter by schema: example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 type: string - name: status required: false in: query description: Status filter schema: example: completed enum: - running - paused - completed - failed - timeout type: string - name: x-username in: header required: false description: >- External user (end user) to act as. Optional — if omitted, Flowra uses the project’s default external user. Send a stable username (e.g. customer_alice) only when you need another end-user context. schema: type: string default: (project default user) example: customer_alice responses: '200': description: Workflow executions retrieved successfully content: application/json: schema: $ref: >- #/components/schemas/WorkflowExecutionListItemDtoPaginatedResponse example: success: true message: Data retrieved successfully data: - id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 workflowId: 7c9e6679-7425-40de-944b-e07fc1f90ae7 workflowName: Support bot projectId: '' eUID: '' isOwnExecution: true userId: '' threadId: b737d8af-a9e0-4251-9714-3fdc1126e5fb assistantId: '' inputData: message: hi outputData: {} status: completed currentNodeId: '' executionSummary: completedNodes: - '' failedNodes: - '' errors: - nodeId: '' nodeType: '' error: '' step: '' totalNodes: 0 executionMode: production workflowType: agent startedAt: '2026-09-03T10:00:00.000Z' completedAt: '2024-01-01T00:00:00.000Z' executionDurationMs: 1820 usage: credits: 0 usdCost: 0 breakdown: ai_model: 0 tool: 0 sandbox: 0 browser: 0 workflow: 0 media: 0 total: 100 totalTools: 5000 page: 1 limit: 20 totalPages: 5 hasNextPage: true hasPreviousPage: false security: - x-api-key: [] - x-api-key: [] x-username: [] components: schemas: WorkflowExecutionListItemDtoPaginatedResponse: type: object properties: success: type: boolean description: Success status example: true message: type: string description: Response message example: Data retrieved successfully data: description: Array of items type: array items: type: object properties: id: type: string description: Execution ID example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 workflowId: type: string description: Workflow (agent) ID example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 workflowName: type: string description: Workflow display name example: Support bot projectId: type: string nullable: true description: Project ID eUID: type: string nullable: true description: External user id (eUID) that triggered this execution isOwnExecution: type: boolean description: >- True when execution.eUID matches the requesting user session eUID (viewer ran it themselves) userId: type: string description: Dashboard user who started the run threadId: type: string nullable: true description: LangGraph thread ID for status polling and resume example: b737d8af-a9e0-4251-9714-3fdc1126e5fb assistantId: type: string nullable: true description: Assistant / graph id inputData: type: object nullable: true description: Input payload sent to EXECUTE example: message: hi outputData: type: object nullable: true description: Final output when the run completed status: type: string enum: - running - paused - completed - failed - timeout description: '`paused` means wait for RESUME with this threadId' example: completed currentNodeId: type: string nullable: true description: Current static-graph node id while running executionSummary: type: object properties: completedNodes: type: array items: type: string failedNodes: type: array items: type: string errors: type: array items: type: object properties: nodeId: type: string nodeType: type: string error: type: string step: type: string required: - nodeId - nodeType - error totalNodes: type: number required: - completedNodes - failedNodes - errors - totalNodes executionMode: type: string enum: - test - production description: '`test` is a mock run; omit or `production` for live' example: production workflowType: type: string enum: - agent - static description: Workflow type (from workflow) startedAt: format: date-time type: string description: When the run started example: '2026-09-03T10:00:00.000Z' completedAt: format: date-time type: string nullable: true description: When the run finished (null while running/paused) executionDurationMs: type: number nullable: true description: Wall-clock duration in milliseconds example: 1820 usage: type: object properties: credits: type: number description: Net credits consumed for this execution/run usdCost: type: number nullable: true description: USD charged to the account for this usage breakdown: type: object properties: ai_model: type: number default: 0 tool: type: number default: 0 sandbox: type: number default: 0 browser: type: number default: 0 workflow: type: number default: 0 media: type: number default: 0 required: - ai_model - tool - sandbox - browser - workflow - media required: - credits - usdCost - breakdown description: Credit usage for this execution when available required: - id - workflowId - isOwnExecution - status - executionMode - startedAt example: - id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 workflowId: 7c9e6679-7425-40de-944b-e07fc1f90ae7 workflowName: Support bot projectId: '' eUID: '' isOwnExecution: true userId: '' threadId: b737d8af-a9e0-4251-9714-3fdc1126e5fb assistantId: '' inputData: message: hi outputData: {} status: completed currentNodeId: '' executionSummary: completedNodes: - '' failedNodes: - '' errors: - nodeId: '' nodeType: '' error: '' step: '' totalNodes: 0 executionMode: production workflowType: agent startedAt: '2026-09-03T10:00:00.000Z' completedAt: '2024-01-01T00:00:00.000Z' executionDurationMs: 1820 usage: credits: 0 usdCost: 0 breakdown: ai_model: 0 tool: 0 sandbox: 0 browser: 0 workflow: 0 media: 0 total: type: number description: Total number of items across all pages example: 100 totalTools: type: number description: >- Optional secondary total (e.g. nested tools across all matching toolkits) example: 5000 page: type: number description: Current page number (1-based) example: 1 limit: type: number description: Number of items per page example: 20 totalPages: type: number description: Total number of pages example: 5 hasNextPage: type: boolean description: Whether there is a next page example: true hasPreviousPage: type: boolean description: Whether there is a previous page example: false required: - success - message - data - total securitySchemes: x-api-key: type: apiKey in: header name: x-api-key description: >- Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key: x-username: type: apiKey in: header name: x-username description: >- Optional. External user username. If omitted, Flowra uses the project’s default external user. Send as header: x-username: ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.