> ## 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 execuções > Utilize este endpoint para recuperar uma lista paginada de execuções de workflows. Você pode filtrar resultados por ID do workflow ou status. ## OpenAPI ````yaml pt/openapi/v3-current/flowker.yaml get /v1/executions openapi: 3.1.0 info: description: >- Referência completa da API para os serviços de orquestração de workflows do Flowker, incluindo gerenciamento de catálogo, definições de workflows, configurações de executores, configurações de provedores e execuções de workflows. title: API do Flowker version: 1.1.1 servers: - url: https://flowker.sandbox.lerian.net security: - ApiKeyAuth: [] tags: - name: Catalog API description: >- Explore provedores, executores e gatilhos integrados disponíveis no catálogo do Flowker. - name: Workflows API description: Crie, atualize, ative, desative, clone e exclua definições de workflows. - name: Executions API description: Inicie execuções de workflows e acompanhe seu status e resultados. - name: Executor Configurations API description: >- Configure, teste e gerencie conexões de executores externos utilizadas pelos nós de workflow. - name: Provider Configurations API description: Configure, teste, habilite e desabilite integrações de provedores. - name: Dashboard API description: >- Recupere resumos agregados de workflows e execuções para dashboards operacionais. - name: Audit API description: >- Consulte e verifique eventos de auditoria para conformidade e visibilidade operacional. - name: Webhooks API description: >- Receba callbacks de webhooks de sistemas externos para disparar execuções de workflows. paths: /v1/executions: get: tags: - Executions API summary: Listar execuções description: >- Utilize este endpoint para recuperar uma lista paginada de execuções de workflows. Você pode filtrar resultados por ID do workflow ou status. operationId: listExecutions parameters: - description: Filtrar resultados por um ID de workflow específico. in: query name: workflowId schema: format: uuid type: string - description: Filtrar resultados por status. in: query name: status schema: enum: - pending - running - completed - failed type: string - description: >- Número máximo de itens a retornar por página. O padrão é 10. Deve estar entre 1 e 100. in: query name: limit schema: default: 10 maximum: 100 minimum: 1 type: integer - description: >- Cursor para paginação. Utilize o valor do campo `nextCursor` de uma resposta anterior para recuperar a próxima página. in: query name: cursor schema: type: string - description: Campo pelo qual ordenar os resultados. in: query name: sortBy schema: default: startedAt enum: - startedAt - completedAt type: string - description: >- Direção de ordenação. Utilize `ASC` para ascendente ou `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 a solicitação foi bem-sucedida e a resposta contém os dados solicitados. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica que a solicitação estava malformada ou continha parâmetros inválidos. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica um erro interno inesperado. Se persistir, entre em contato com o suporte. 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 se há mais páginas disponíveis. example: false type: boolean items: description: Lista de status de execução na página atual. items: $ref: '#/components/schemas/ExecutionStatusOutput' type: array nextCursor: description: Cursor para a próxima página. example: '' type: string type: object ErrorResponse: properties: code: description: Código de erro legível por máquina com o prefixo FLK. example: FLK-0001 type: string message: description: Explicação do erro legível por humanos. example: Invalid input provided type: string title: description: Título curto da categoria de erro. example: Bad Request type: string required: - code - message - title type: object ExecutionStatusOutput: properties: completedAt: description: >- Marca temporal de quando a execução foi finalizada. Nulo se ainda estiver em execução. example: '2026-03-17T14:35:12Z' format: date-time type: string currentStepNumber: description: Número do passo sendo executado atualmente (indexado a partir de 1). example: 1 type: integer errorMessage: description: Mensagem de erro se a execução falhou. Nulo em caso de sucesso. type: string executionId: description: Identificador único da execução. example: f7e6d5c4-b3a2-1098-7654-321fedcba098 format: uuid type: string startedAt: description: Marca temporal de quando a execução foi iniciada. example: '2026-03-17T14:35:00Z' format: date-time type: string status: description: >- Status atual: `pending` (na fila), `running` (em andamento), `completed` (sucesso) ou `failed` (erro). enum: - pending - running - completed - failed example: completed type: string totalSteps: description: Número total de passos no workflow. example: 1 type: integer workflowId: description: ID do workflow sendo executado. example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 format: uuid type: string type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Chave de API para autenticar as requisições à API do Flowker. Provisionada por meio da variável de ambiente API_KEY durante o deployment. ````