> ## 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. # Listar ejecuciones > Utilice este endpoint para recuperar una lista paginada de ejecuciones de workflows. Puede filtrar resultados por ID del workflow o estado. ## OpenAPI ````yaml es/openapi/v3-current/flowker.yaml get /v1/executions openapi: 3.1.0 info: description: >- Referencia completa de la API para los servicios de orquestación de workflows de Flowker, incluyendo gestión de catálogo, definiciones de workflows, configuraciones de ejecutores, configuraciones de proveedores y ejecuciones de workflows. title: API de Flowker version: 1.1.1 servers: - url: https://flowker.sandbox.lerian.net security: - ApiKeyAuth: [] tags: - name: Catalog API description: >- Explore proveedores, ejecutores y disparadores integrados disponibles en el catálogo de Flowker. - name: Workflows API description: >- Cree, actualice, active, desactive, clone y elimine definiciones de workflows. - name: Executions API description: Inicie ejecuciones de workflows y rastree su estado y resultados. - name: Executor Configurations API description: >- Configure, pruebe y administre conexiones de ejecutores externos utilizadas por los nodos de workflow. - name: Provider Configurations API description: Configure, pruebe, habilite y deshabilite integraciones de proveedores. - name: Dashboard API description: >- Recupere resúmenes agregados de workflows y ejecuciones para dashboards operacionales. - name: Audit API description: >- Consulte y verifique eventos de auditoría para cumplimiento y visibilidad operacional. - name: Webhooks API description: >- Reciba callbacks de webhooks desde sistemas externos para disparar ejecuciones de workflows. paths: /v1/executions: get: tags: - Executions API summary: Listar ejecuciones description: >- Utilice este endpoint para recuperar una lista paginada de ejecuciones de workflows. Puede filtrar resultados por ID del workflow o estado. operationId: listExecutions parameters: - description: Filtrar resultados por un ID de workflow específico. in: query name: workflowId schema: format: uuid type: string - description: Filtrar resultados por estado. in: query name: status schema: enum: - pending - running - completed - failed type: string - description: >- Número máximo de elementos a retornar por página. Por defecto es 10. Debe estar entre 1 y 100. in: query name: limit schema: default: 10 maximum: 100 minimum: 1 type: integer - description: >- Cursor para paginación. Utilice el valor del campo `nextCursor` de una respuesta anterior para recuperar la siguiente página. in: query name: cursor schema: type: string - description: Campo por el cual ordenar los resultados. in: query name: sortBy schema: default: startedAt enum: - startedAt - completedAt type: string - description: >- Dirección de ordenamiento. Utilice `ASC` para ascendente o `DESC` para descendente. in: query name: sortOrder schema: default: DESC enum: - ASC - DESC type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExecutionListOutput' description: >- Indica que la solicitud fue exitosa y la respuesta contiene los datos solicitados. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica que la solicitud estaba mal formada o contenía parámetros no válidos. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica un error interno inesperado. Si persiste, contacte al soporte. 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: Indica si hay más páginas disponibles. example: false type: boolean items: description: Lista de estados de ejecución en la página actual. items: $ref: '#/components/schemas/ExecutionStatusOutput' type: array nextCursor: description: Cursor para la siguiente página. example: '' type: string type: object ErrorResponse: properties: code: description: Código de error legible por máquina con el prefijo FLK. example: FLK-0001 type: string message: description: Explicación del error legible por humanos. example: Invalid input provided type: string title: description: Título corto de categoría de error. example: Bad Request type: string required: - code - message - title type: object ExecutionStatusOutput: properties: completedAt: description: >- Marca de tiempo de cuando finalizó la ejecución. Nulo si aún está en ejecución. example: '2026-03-17T14:35:12Z' format: date-time type: string currentStepNumber: description: >- Número del paso que se está ejecutando actualmente (indexado desde 1). example: 1 type: integer errorMessage: description: Mensaje de error si la ejecución falló. Nulo en caso de éxito. type: string executionId: description: Identificador único de la ejecución. example: f7e6d5c4-b3a2-1098-7654-321fedcba098 format: uuid type: string startedAt: description: Marca de tiempo de cuando se inició la ejecución. example: '2026-03-17T14:35:00Z' format: date-time type: string status: description: >- Estado actual: `pending` (en cola), `running` (en progreso), `completed` (exitoso) o `failed` (error). enum: - pending - running - completed - failed example: completed type: string totalSteps: description: Número total de pasos en el workflow. example: 1 type: integer workflowId: description: ID del workflow que se está ejecutando. example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 format: uuid type: string type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Clave de API para autenticar las solicitudes a la API de Flowker. Se aprovisiona mediante la variable de entorno API_KEY durante el despliegue. ````