---
title: "Transições de etapas"
method: GET
path: "/api/management/project-funnels/{project_funnel_id}/step-transitions"
tags: ["project-funnels", "Métricas"]
---

# Transições de etapas

`GET /api/management/project-funnels/{project_funnel_id}/step-transitions`

Lista o histórico de entradas e saídas das etapas do funil, com quem moveu, quando e quanto tempo o projeto ficou em cada etapa. É a base bruta das métricas: cada registro traz a etapa, o usuário de entrada e de saída e a transição anterior que o originou. O resultado é paginado. Ver [Métricas e tempo por etapa](https://docs.olie.ai/guides/funnels/metrics) e [Paginação](https://docs.olie.ai/api-reference/general/pagination).

## Query parameters

- `project_id` string
- `funnel_step_id` integer
- `user_id` string
- `start_date` string
- `end_date` string
- `page` integer
- `perPage` string

## Response `200`

Sucesso

- object
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `funnel_step_transitions` object[], required — Transições encontradas.
    - `id` integer — ID da transição.
    - `entry_time` string, date-time — Momento em que o projeto entrou na etapa.
    - `exit_time` string, date-time — Momento da saída. Nulo enquanto o projeto continua na etapa.
    - `project_id` string, uuid — ID (UUID) do projeto.
    - `funnel_step_id` integer — ID da etapa.
    - `exit_parent_id` integer — ID da transição anterior, de onde o projeto veio.
    - `entry_user_id` string, uuid — Usuário que moveu o projeto para a etapa.
    - `exit_user_id` string, uuid — Usuário que tirou o projeto da etapa.
    - `duration_seconds` integer — Tempo de permanência em segundos. Nulo enquanto não houver saída.
    - `funnel_step` object — Etapa da transição.
      - `id` integer — ID da etapa.
      - `name` string — Nome da etapa.
    - `exit_parent` object — Transição anterior, no mesmo formato.
    - `entry_user` object — Usuário da entrada.
    - `exit_user` object — Usuário da saída.
  - `meta` object, required — Metadados da paginação.
    - `current_page` integer — Página atual.
    - `from` integer — Índice do primeiro item da página.
    - `to` integer — Índice do último item da página.
    - `last_page` integer — Última página disponível.
    - `per_page` integer — Itens por página.
    - `total` integer — Total de itens.

## Other responses

- `401` — Não autorizado
- `422` — Validação falhou

## Changes

- **2026-08-24** `3c590152d5b5` — 11 breaking, 17 warning, 10 info
  - the response property `funnel_step_transitions/items/duration_seconds` became nullable for the status `200`
  - the response property `funnel_step_transitions/items/entry_user` became nullable for the status `200`
  - the response property `funnel_step_transitions/items/entry_user_id` became nullable for the status `200`
  - the response property `funnel_step_transitions/items/exit_parent` became nullable for the status `200`
  - …34 more
- **2026-08-19** `f521a8dfa4f7` — 1 info
  - added the new optional `query` request parameter `perPage`
- **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/step-transitions/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/d7bda7d32f67?raw)