> ## 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 métricas de etapas do projeto

> Retorna, para cada etapa dos funis em que o projeto está cadastrado, o tempo que ele já passou ali — a soma de todas as passagens encerradas, em segundos. Passagens ainda em curso não entram na conta, e etapas por onde o projeto nunca passou vêm com zero.

Para as métricas do funil como um todo, veja [Métricas do funil](https://docs.olie.ai/guides/funnels/metrics).



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/projects/{project}/step-metrics
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}/step-metrics:
    parameters:
      - name: project
        in: path
        required: true
        description: ID (UUID) do projeto.
        schema:
          type: string
        example: '{{project_id}}'
    get:
      tags:
        - projects
        - Métricas e previsão
      summary: Obter métricas de etapas do projeto
      description: >-
        Retorna, para cada etapa dos funis em que o projeto está cadastrado, o
        tempo que ele já passou ali — a soma de todas as passagens encerradas,
        em segundos. Passagens ainda em curso não entram na conta, e etapas por
        onde o projeto nunca passou vêm com zero.


        Para as métricas do funil como um todo, veja [Métricas do
        funil](https://docs.olie.ai/guides/funnels/metrics).
      operationId: obterMTricasComputadasDasEtapasDeUmProjetoEspecFicoNoFunil
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: Tempo do projeto por etapa.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre true quando a operação é concluída.
                  metrics:
                    type: array
                    description: Uma entrada por etapa dos funis do projeto.
                    items:
                      description: Métrica de uma etapa.
                      type: object
                      properties:
                        step_id:
                          type: integer
                          description: ID da etapa.
                        max_time:
                          type: object
                          description: >-
                            Tempo somado de todas as passagens encerradas pela
                            etapa.
                          properties:
                            value:
                              type: integer
                              description: Tempo acumulado pelo projeto na etapa.
                            unit:
                              type: string
                              description: Unidade do valor. Sempre `seconds`.
                required:
                  - response
                  - metrics
              example:
                response: true
                metrics:
                  - step_id: 123
                    max_time:
                      value: 0
                      unit: seconds
                      meta_data: null
                  - step_id: 124
                    max_time:
                      value: 0
                      unit: seconds
                      meta_data: null
                  - step_id: 125
                    max_time:
                      value: 0
                      unit: seconds
                      meta_data: null
                  - step_id: 126
                    max_time:
                      value: 0
                      unit: seconds
                      meta_data: null
                  - step_id: 127
                    max_time:
                      value: 0
                      unit: seconds
                      meta_data: null
                  - step_id: 128
                    max_time:
                      value: 0
                      unit: seconds
                      meta_data: null
                  - step_id: 129
                    max_time:
                      value: 0
                      unit: seconds
                      meta_data: null
                  - step_id: 130
                    max_time:
                      value: 0
                      unit: seconds
                      meta_data: null
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````