> ## 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 da empresa

> Lista as execuções (registros de tempo) de toda a empresa, com paginação, filtros e ordenação. Só entram execuções de projetos que você pode ver. Sem permissão para ver os timers de outras pessoas, a lista traz apenas as suas, e filtrar por outro usuário retorna 403.

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



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/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/project-executions:
    get:
      tags:
        - projects
        - Execuções
      summary: Listar execuções da empresa
      description: >-
        Lista as execuções (registros de tempo) de toda a empresa, com
        paginação, filtros e ordenação. Só entram execuções de projetos que você
        pode ver. Sem permissão para ver os timers de outras pessoas, a lista
        traz apenas as suas, e filtrar por outro usuário retorna 403.


        Veja [Paginação](https://docs.olie.ai/api-reference/general/pagination)
        e [Filtros
        básicos](https://docs.olie.ai/api-reference/general/basic-filters).
      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) da pessoa dona das execuções. Aceita vários separados por
            vírgula. Outra pessoa que não você exige permissão para ver os
            timers dos outros.
          schema:
            type: string
          example: ''
        - name: filter[project_id]
          in: query
          description: ID (UUID) do projeto. Aceita vários separados por vírgula.
          schema:
            type: string
          example: ''
        - name: filter[funnel_step_id]
          in: query
          description: ID da etapa do funil em que a execução ocorreu.
          schema:
            type: string
          example: ''
        - name: filter[project_funnel_id]
          in: query
          description: ID do funil da etapa. Aceita vários separados por vírgula.
          schema:
            type: string
          example: ''
        - name: filter[start_date_gt]
          in: query
          description: Retorna execuções iniciadas nesta data ou depois dela.
          schema:
            type: string
          example: ''
        - name: filter[end_date_lt]
          in: query
          description: Retorna execuções encerradas nesta data ou antes dela.
          schema:
            type: string
          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: filter[in_range]
          in: query
          description: >-
            Início e fim separados por vírgula. Retorna execuções que ocupam
            algum tempo nesse intervalo, inclusive as que começaram antes e
            ainda estavam abertas.
          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:
                type: object
                properties:
                  response:
                    type: boolean
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                      from:
                        type: integer
                      last_page:
                        type: integer
                      per_page:
                        type: integer
                      to:
                        type: integer
                      total:
                        type: integer
                  project_executions:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        project_id:
                          type: string
                        user_id:
                          type: string
                        funnel_step_id:
                          type: integer
                        started_at:
                          type: string
                          format: date-time
                        finished_at:
                          nullable: true
                        hourly_rate:
                          type: integer
                        finished_reason:
                          nullable: true
                        started_at_real:
                          nullable: true
                        finished_at_real:
                          nullable: true
                        duration:
                          type: integer
                        project:
                          type: object
                          properties:
                            id:
                              type: string
                            code:
                              type: string
                            name:
                              type: string
                            is_template:
                              type: boolean
                            deleted_at:
                              nullable: true
                            customer:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                        user:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            avatar_url:
                              nullable: true
                        funnel_step:
                          type: object
                          properties:
                            id:
                              type: integer
                            name:
                              type: string
                            project_funnel_id:
                              type: integer
                            funnel:
                              type: object
                              properties:
                                id:
                                  type: integer
                                name:
                                  type: string
              example:
                response: true
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  per_page: 30
                  to: 2
                  total: 2
                project_executions:
                  - id: a1f0c3d2-5b6e-4f70-8a91-b2c3d4e5f607
                    project_id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                    user_id: 019c1e87-63f4-71dd-a4e3-6eaea0619c2f
                    funnel_step_id: 181
                    started_at: '2026-10-30T12:00:00.000000Z'
                    finished_at: null
                    hourly_rate: 85
                    finished_reason: null
                    started_at_real: null
                    finished_at_real: null
                    duration: 2700
                    project:
                      id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                      code: SC-1
                      name: Shopping Center
                      is_template: false
                      deleted_at: null
                      customer:
                        id: 019d2a41-7c3e-7b10-8f6e-1a2b3c4d5e6f
                        name: Cliente Exemplo Ltda
                    user:
                      id: 019c1e87-63f4-71dd-a4e3-6eaea0619c2f
                      name: Nome do usuário
                      avatar_url: null
                    funnel_step:
                      id: 181
                      name: Execução
                      project_funnel_id: 36
                      funnel:
                        id: 36
                        name: Obras
                  - 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
                    duration: 6132
                    project:
                      id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                      code: SC-1
                      name: Shopping Center
                      is_template: false
                      deleted_at: null
                      customer:
                        id: 019d2a41-7c3e-7b10-8f6e-1a2b3c4d5e6f
                        name: Cliente Exemplo Ltda
                    user:
                      id: 019c1e87-63f4-71dd-a4e3-6eaea0619c2f
                      name: Nome do usuário
                      avatar_url: null
                    funnel_step:
                      id: 181
                      name: Execução
                      project_funnel_id: 36
                      funnel:
                        id: 36
                        name: Obras
        '403':
          description: Filtrar outro usuário sem permissão
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: boolean
                  message:
                    type: string
                  error:
                    type: string
                  permission:
                    type: string
              example:
                response: false
                message: permission_required
                error: This action is unauthorized.
                permission: projects_executions.see_timers
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.