---
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 — Resposta contendo o histórico de transições entre etapas do funil de um projeto.
  - `funnel_step_transitions` object[] — Lista de movimentações do projeto entre etapas do funil.
    - `id` integer — Identificador único da transição.
    - `entry_time` string, date-time — Data e hora em que o projeto entrou na etapa.
    - `exit_time` string, date-time — Data e hora em que o projeto saiu da etapa. Será null caso ainda esteja ativo nesta etapa.
    - `project_id` string — ID do projeto relacionado à transição.
    - `funnel_step_id` integer — ID da etapa do funil.
    - `exit_parent_id` integer — ID da próxima transição relacionada.
    - `entry_user_id` string — ID do usuário responsável pela entrada na etapa.
    - `exit_user_id` string — ID do usuário responsável pela saída da etapa.
    - `duration_seconds` integer — Tempo total de permanência na etapa em segundos.
    - `funnel_step` object — Informações da etapa do funil.
      - `id` integer — ID da etapa.
      - `name` string — Nome da etapa do funil.
    - `exit_parent` object — Próxima transição vinculada a esta movimentação.
      - `id` integer — ID da transição.
      - `entry_time` string, date-time — Data e hora de entrada na etapa.
      - `exit_time` string, date-time — Data e hora de saída da etapa.
      - `project_id` string — ID do projeto relacionado.
      - `funnel_step_id` integer — ID da etapa.
      - `exit_parent_id` integer — ID da próxima transição vinculada.
      - `entry_user_id` string — ID do usuário responsável pela entrada.
      - `exit_user_id` string — ID do usuário responsável pela saída.
      - `duration_seconds` integer — Tempo de permanência na etapa em segundos.
      - `funnel_step` object — Informações da etapa relacionada.
        - `id` integer — ID da etapa.
        - `name` string — Nome da etapa.
    - `entry_user` object — Usuário responsável pela entrada na etapa.
      - `id` string — ID do usuário.
      - `name` string — Nome do usuário.
      - `avatar_url` string, uri — URL da imagem de avatar do usuário.
    - `exit_user` object — Usuário responsável pela saída da etapa.
      - `id` string — ID do usuário.
      - `name` string — Nome do usuário.
      - `avatar_url` string, uri — URL da imagem de avatar do usuário.
  - `meta` object — Metadados de paginação da resposta.
    - `current_page` integer — Página atual.
    - `from` integer — Índice inicial dos registros retornados.
    - `last_page` integer — Última página disponível.
    - `per_page` integer — Quantidade de registros por página.
    - `to` integer — Índice final dos registros retornados.
    - `total` integer — Quantidade total de registros.
  - `response` boolean — Indica se a requisição foi concluída com sucesso.

## Other responses

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

---

[API](https://skmtc.net/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.net/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/063de6e2e93c/schema)