---
title: "Métricas do funil"
method: GET
path: "/api/management/project-funnels/{project_funnel_id}/metrics"
tags: ["project-funnels", "Métricas"]
---

# Métricas do funil

`GET /api/management/project-funnels/{project_funnel_id}/metrics`

Consolida os números do funil no período: contagens de projetos e etapas, distribuição e ocupação por etapa, tempo médio no funil e por etapa, atividade recente, uso de etiquetas e status e os anexos do funil. Sem `start_date` e `end_date` o período são os últimos 30 dias; o intervalo informado não pode passar de 3 meses e as datas devem estar em `YYYY-MM-DD`. Ver [Métricas e tempo por etapa](https://docs.olie.ai/guides/funnels/metrics).

## Query parameters

- `start_date` string, date
- `end_date` string

## Response `200`

Sucesso

- object
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `metrics` object, required — Métricas do funil no período.
    - `period` object — Período efetivamente usado no cálculo.
      - `start_date` string, date — Início do período considerado.
      - `end_date` string, date — Fim do período considerado.
      - `is_default` boolean — Indica que o período veio do padrão de 30 dias, por não ter sido informado.
    - `basic` object — Identificação e configuração básica do funil.
      - `id` integer — ID do funil.
      - `name` string — Nome do funil.
      - `condition` 'active' | 'inactive' — Situação do funil.
      - `steps` object[] — Etapas do funil.
      - `funnel_form` object — Formulário de vínculo do funil.
      - `business_area` object — Área de negócio do funil.
      - `created_at` string, date-time — Data de criação do funil.
      - `updated_at` string, date-time — Data da última alteração.
    - `counts` object — Totais do funil.
      - `total_steps` integer — Quantidade de etapas.
      - `total_projects` integer — Projetos vinculados ao funil.
      - `active_projects` integer — Projetos em andamento.
      - `tags_count` integer — Etiquetas cadastradas.
      - `attachments_count` integer — Anexos do funil.
    - `steps_distribution` object[] — Movimento de cada etapa no período.
      - `step_id` integer — ID da etapa.
      - `step_name` string — Nome da etapa.
      - `projects_count` integer — Projetos atualmente na etapa.
      - `projects_entry_in_period` integer — Projetos que entraram na etapa no período.
      - `projects_exit_in_period` integer — Projetos que saíram da etapa no período.
    - `steps_summary` object — Resumo da ocupação das etapas.
      - `most_occupied_step` object — Etapa com mais projetos no momento.
      - `empty_steps_ids` integer[] — Etapas sem nenhum projeto.
      - `empty_steps_count` integer — Quantidade de etapas vazias.
    - `time_metrics` object — Tempos do funil e por etapa.
      - `average_time_in_funnel_minutes` number — Tempo médio, em minutos, que os projetos passam no funil.
      - `average_time_per_step_minutes` object[] — Tempo médio por etapa.
        - `step_id` integer — ID da etapa.
        - `step_name` string — Nome da etapa.
        - `average_time_minutes` number — Tempo médio de permanência, em minutos.
      - `oldest_project_id` string, uuid — Projeto há mais tempo no funil.
      - `newest_project_id` string, uuid — Projeto mais recente no funil.
      - `oldest_project_minutes` number — Tempo, em minutos, do projeto mais antigo.
      - `newest_project_minutes` number — Tempo, em minutos, do projeto mais recente.
    - `activity` object — Atividade recente.
      - `last_activity_at` string, date-time — Última movimentação registrada no funil.
      - `projects_added_in_period` integer — Projetos que entraram no funil no período.
    - `tags` object[] — Uso das etiquetas do funil.
      - `id` integer — ID do item.
      - `name` string — Nome do item.
      - `color` string — Cor em hexadecimal.
      - `projects_count` integer — Projetos do funil com este item aplicado.
    - `funnel_status` object[] — Uso dos status do funil.
      - `id` integer — ID do item.
      - `name` string — Nome do item.
      - `color` string — Cor em hexadecimal.
      - `projects_count` integer — Projetos do funil com este item aplicado.
    - `attachments` object[] — Anexos do funil.

## Changes

- **2026-08-24** `3c590152d5b5` — 67 breaking, 10 warning, 2 info
  - the response property `metrics/activity/last_activity_at` became nullable for the status `200`
  - the response property `metrics/basic/business_area` became nullable for the status `200`
  - the response property `metrics/basic/funnel_form` became nullable for the status `200`
  - the response property `metrics/funnel_status/items/color` became nullable for the status `200`
  - …75 more
- **2026-08-19** `f3efb100a3fc` — 2 info
  - api tag `Métricas` added
  - api tag `{project_funnel_id}` removed

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/project-funnels/:project_funnel_id/metrics/get.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/d71b18b1685d?raw)