> ## 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.

# Obter uma execução

> Retorna uma execução específica com o projeto, a etapa do funil e o usuário relacionados. O valor hora só aparece para quem tem acesso a custos.



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/project-executions/{project_execution_id}
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/{project_execution_id}:
    parameters:
      - name: project_execution_id
        in: path
        required: true
        deprecated: false
        schema:
          type: string
          format: uuid
        example: aeb08293-dfd2-365f-9867-93c1251db399
    get:
      tags:
        - projects
        - Execuções
      summary: Obter uma execução
      description: >-
        Retorna uma execução específica com o projeto, a etapa do funil e o
        usuário relacionados. O valor hora só aparece para quem tem acesso a
        custos.
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: Execução consultada.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre true quando a operação é concluída.
                  project_execution:
                    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_execution
              example:
                response: true
                project_execution:
                  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
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````