> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar execuções de um projeto

> Lista as execuções registradas em um projeto, com paginação. Aceita recortes por pessoa, por etapa e por período, e ordenação por início ou término.

Consulte [Filtro básico](https://docs.olie.ai/api-reference/general/basic-filters) e [Paginação](https://docs.olie.ai/api-reference/general/pagination).



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/projects/{project}/project-executions
openapi: 3.0.0
info:
  title: Olie API
  version: 1.0.0
  description: >
    # Introdução 👋


    Olá! Esta é a documentação oficial da API da [olie.ai](https://olie.ai/).
    Aqui você encontra as referências e exemplos de uso dos nossos endpoints.


    Para uma visão completa, recomendamos fortemente que você leia a
    [documentação oficial](https://docs.olie.ai/api-reference/introduction). Lá
    estão detalhados tópicos essenciais como
    [autenticação](https://docs.olie.ai/api-reference/introduction/authentication),
    [estrutura de
    respostas](https://docs.olie.ai/api-reference/general/response-structure),
    [paginação](https://docs.olie.ai/api-reference/general/pagination) e outros
    guias de integração.


    No Postman, esta coleção foca nas informações específicas de cada requisição
    (endpoints, parâmetros e exemplos), servindo como apoio rápido para testes e
    desenvolvimento.
servers:
  - url: https://api.olie.ai
security:
  - BearerAuth: []
paths:
  /api/management/projects/{project}/project-executions:
    parameters:
      - name: project
        in: path
        required: true
        description: ID (UUID) do projeto.
        schema:
          type: string
        example: '{{project_id}}'
    get:
      tags:
        - projects
        - Execuções
      summary: Listar execuções de um projeto
      description: >-
        Lista as execuções registradas em um projeto, com paginação. Aceita
        recortes por pessoa, por etapa e por período, e ordenação por início ou
        término.


        Consulte [Filtro
        básico](https://docs.olie.ai/api-reference/general/basic-filters) e
        [Paginação](https://docs.olie.ai/api-reference/general/pagination).
      parameters:
        - name: page
          in: query
          description: Página desejada. Padrão `1`.
          schema:
            type: string
          example: ''
        - name: perPage
          in: query
          description: Itens por página. Padrão `30`, máximo `100`.
          schema:
            type: string
          example: ''
        - name: filter[user_id]
          in: query
          description: ID (UUID) do usuário dono das execuções.
          schema:
            type: string
            format: uuid
          example: ''
        - name: filter[funnel_step_id]
          in: query
          description: ID da etapa do funil em que a execução ocorreu.
          schema:
            type: integer
          example: 0
        - name: filter[start_date_gt]
          in: query
          description: Retorna execuções iniciadas nesta data ou depois dela.
          schema:
            type: string
            format: date-time
          example: ''
        - name: filter[end_date_lt]
          in: query
          description: Retorna execuções encerradas nesta data ou antes dela.
          schema:
            type: string
            format: date-time
          example: ''
        - name: filter[is_running]
          in: query
          description: >-
            `true` retorna apenas as execuções em andamento; `false`, apenas as
            encerradas.
          schema:
            type: string
          example: ''
        - name: sort
          in: query
          description: >-
            Ordenação por `started_at` ou `finished_at`. Use `-` antes do campo
            para ordem decrescente.
          schema:
            type: string
          example: ''
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: Lista paginada de execuções do projeto.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre true quando a operação é concluída.
                  meta:
                    type: object
                    description: Dados da paginação.
                    properties:
                      current_page:
                        type: integer
                        description: Página retornada.
                      from:
                        type: integer
                        description: Posição do primeiro item da página no total.
                      to:
                        type: integer
                        description: Posição do último item da página no total.
                      last_page:
                        type: integer
                        description: Número da última página.
                      per_page:
                        type: integer
                        description: Itens por página.
                      total:
                        type: integer
                        description: Total de itens encontrados.
                  project_executions:
                    type: array
                    description: Execuções da página.
                    items:
                      description: Registro de tempo de trabalho.
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID (UUID) da execução.
                          format: uuid
                        project_id:
                          type: string
                          description: Projeto em que o tempo foi contado.
                          format: uuid
                        user_id:
                          type: string
                          description: Pessoa que executou.
                          format: uuid
                        funnel_step_id:
                          type: integer
                          description: Etapa do funil em que o tempo foi contado.
                        started_at:
                          type: string
                          description: Início da contagem.
                          format: date-time
                        finished_at:
                          type: string
                          description: >-
                            Término da contagem. `null` enquanto a execução está
                            em andamento.
                          format: date-time
                        hourly_rate:
                          type: number
                          description: >-
                            Valor hora aplicado. Só aparece para quem tem acesso
                            a custos.
                        finished_reason:
                          type: string
                          description: >-
                            Motivo do encerramento: `self_stop`,
                            `scheduled_stop`, `step_moved`, `project_deleted`,
                            `project_template` ou `step_deleted`.
                        started_at_real:
                          type: string
                          description: >-
                            Início original, quando o horário foi ajustado
                            depois.
                          format: date-time
                        finished_at_real:
                          type: string
                          description: >-
                            Término original, quando o horário foi ajustado
                            depois.
                          format: date-time
                        project:
                          type: object
                          description: Projeto da execução.
                        user:
                          type: object
                          description: Pessoa que executou.
                        funnel_step:
                          type: object
                          description: Etapa e funil da execução.
                required:
                  - response
                  - project_executions
              example:
                response: true
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  per_page: 30
                  to: 2
                  total: 2
                project_executions:
                  - id: a14afcbd-38b1-4b97-8950-02c09547611a
                    project_id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                    user_id: 019c1e87-63f4-71dd-a4e3-6eaea0619c2f
                    funnel_step_id: 181
                    started_at: '2026-08-19T13:05:00.000000Z'
                    finished_at: '2026-08-19T14:47:12.000000Z'
                    hourly_rate: 85
                    finished_reason: self_stop
                    started_at_real: null
                    finished_at_real: null
                    project:
                      id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                      code: SC-1
                      name: Shopping Center
                      is_template: false
                      deleted_at: null
                    user:
                      id: 019c1e87-63f4-71dd-a4e3-6eaea0619c2f
                      name: Ana Souza
                      avatar_url: null
                    funnel_step:
                      id: 181
                      name: Execução
                      project_funnel_id: 36
                      funnel:
                        id: 36
                        name: Obras
                  - id: a14afbe7-d2bc-4821-9c2b-7ce295f8a962
                    project_id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                    user_id: 019c1e87-63f4-71dd-a4e3-6eaea0619c2f
                    funnel_step_id: 181
                    started_at: '2026-08-18T09:12:44.000000Z'
                    finished_at: '2026-08-18T11:30:00.000000Z'
                    hourly_rate: 85
                    finished_reason: step_moved
                    started_at_real: null
                    finished_at_real: null
                    project:
                      id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                      code: SC-1
                      name: Shopping Center
                      is_template: false
                      deleted_at: null
                    user:
                      id: 019c1e87-63f4-71dd-a4e3-6eaea0619c2f
                      name: Ana Souza
                      avatar_url: null
                    funnel_step:
                      id: 181
                      name: Execução
                      project_funnel_id: 36
                      funnel:
                        id: 36
                        name: Obras
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````