---
title: "Obter dados da etapa"
method: POST
path: "/api/management/get-step-data"
tags: ["funnel-steps", "Etapas"]
---

# Obter dados da etapa

`POST /api/management/get-step-data`

Carrega o conteúdo das colunas do quadro: para cada etapa informada, devolve os projetos visíveis ao usuário autenticado, já recortados por `offset`/`limit`, e o total de projetos da etapa. Com `is_counting` a resposta traz apenas os totalizadores da etapa — contagem e soma de orçamento — sem a lista de projetos, que é o modo usado para montar os cabeçalhos das colunas. O quadro está descrito em [Configuração do quadro](https://docs.olie.ai/guides/funnels/board-view) e o formato de `filters` segue [Busca avançada](https://docs.olie.ai/api-reference/general/advanced-search).

## Request body

- object
  - `steps` object[], required — Etapas a carregar. O `id` não pode se repetir.
    - `id` integer, required — ID da etapa a carregar.
    - `offset` integer — Quantidade de projetos a pular. Padrão 0.
    - `limit` integer — Quantidade máxima de projetos a retornar. Padrão 20.
    - `sorting` object — Ordenação dos projetos da etapa. Sem ela, a ordem é por data de criação decrescente.
      - `field` string — Campo de ordenação. Vazio desativa a ordenação.
      - `direction` 'asc' | 'desc' — Sentido da ordenação.
      - `arguments` string[] — Argumentos adicionais exigidos por campos compostos.
  - `is_counting` boolean — Quando true, retorna apenas os totalizadores da etapa, sem a lista de projetos.
  - `filters` object[] — Filtros aplicados aos projetos de todas as etapas informadas.
  - `date_range` object — Recorte pela data de entrada do projeto na etapa.
    - `init` string, date — Data inicial. Não pode ser futura. Padrão: 30 dias atrás.
    - `end` string, date — Data final. Não pode ser futura nem anterior a `init`. Padrão: hoje.

## Response `200`

Sucesso

- object
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `steps` object[], required — Etapas solicitadas, na ordem em que foram encontradas.
    - `id` integer — ID da etapa.
    - `project_funnel_id` integer — ID do funil dono da etapa.
    - `sort_config` object — Configuração de ordenação automática salva na etapa.
    - `projects` object[] — Projetos visíveis ao usuário no recorte pedido.
      - `id` string, uuid — ID (UUID) do projeto.
      - `parent_id` string, uuid — ID do projeto pai, quando é um subprojeto.
      - `code` string — Código do projeto, com o prefixo do funil.
      - `name` string — Nome do projeto.
      - `description` string — Descrição do projeto.
      - `impact` integer — Grau de impacto do projeto.
      - `budget` number — Orçamento do projeto.
      - `frame_id` string, uuid — ID (UUID) da conta dona do projeto.
      - `created_at` string, date-time — Data de criação.
      - `updated_at` string, date-time — Data da última alteração.
    - `projects_count` integer — Total de projetos da etapa após filtros e permissões, ignorando `offset` e `limit`.

## Other responses

- `422` — Validação falhou

## Changes

- **2026-09-18** `4a8f726dba52` — 6 breaking
  - the request property `date_range` became not nullable
  - the request property `date_range/end` became not nullable
  - the request property `date_range/init` became not nullable
  - the request property `steps/items/limit` became not nullable
  - …2 more
- **2026-08-24** `3c590152d5b5` — 14 breaking, 7 warning, 13 info
  - request property `steps/items/sorting/direction` was restricted to a list of enum values
  - the request property `steps/items/id` became not nullable
  - the request property `steps` became required
  - the request property `steps/items/id` became required
  - …30 more
- **2026-08-19** `a7c4c54005a5` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `422`
- **2026-08-19** `d6832ed1714a` — 1 info
  - added optional request body
- **2026-08-19** `d85127746782` — 2 info
  - api tag `Etapas` added
  - api tag `get-step-data` removed

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/get-step-data/post.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)