---
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, nullable — Quantidade de projetos a pular. Padrão 0.
    - `limit` integer, nullable — Quantidade máxima de projetos a retornar. Padrão 20.
    - `sorting` object, nullable — 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, nullable — Recorte pela data de entrada do projeto na etapa.
    - `init` string, date, nullable — Data inicial. Não pode ser futura. Padrão: 30 dias atrás.
    - `end` string, date, nullable — 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, nullable — 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, nullable — 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, nullable — Descrição do projeto.
      - `impact` integer, nullable — Grau de impacto do projeto.
      - `budget` number, nullable — 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-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-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/8c9bac94e5ad/schema)