---
title: "Listar etapas disponíveis"
method: GET
path: "/api/management/get-available-steps"
tags: ["funnel-steps", "Etapas"]
---

# Listar etapas disponíveis

`GET /api/management/get-available-steps`

Lista os funis da conta com suas etapas, etiquetas e status, para alimentar seletores de destino em telas de movimentação, automação e filtros. Os parâmetros `id` e `search` filtram etapas, etiquetas e status ao mesmo tempo e devolvem apenas os funis que tiverem alguma correspondência — `id` tem precedência sobre `search`. Os conceitos estão em [Etapas do funil](https://docs.olie.ai/guides/funnels/steps) e [Etiquetas, status e previsão](https://docs.olie.ai/guides/funnels/tags-and-status).

## Query parameters

- `search` string
- `id` string

## Response `200`

Sucesso

- object
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `funnels` object[], required — Funis da conta com etapas, etiquetas e status.
    - `id` integer — ID do funil.
    - `name` string — Nome do funil.
    - `frame_id` string, uuid — ID (UUID) da conta dona do funil.
    - `condition` 'active' | 'inactive' — Situação do funil: `active` ou `inactive`.
    - `allow_multi_step` boolean — Indica se o funil permite o projeto em várias etapas ao mesmo tempo.
    - `form_id` integer, nullable — ID do formulário de vínculo do funil, quando houver.
    - `allow_execution` boolean — Indica se o funil permite cronometrar execução.
    - `steps` object[] — Etapas do funil que atenderam ao filtro.
      - `id` integer — ID da etapa.
      - `name` string — Nome da etapa.
      - `project_funnel_id` integer — ID do funil dono da etapa.
      - `form_id` integer, nullable — ID do formulário vinculado à etapa.
      - `allow_execution` boolean — Indica se a etapa permite cronometrar execução.
      - `checklists` object[] — Itens de checklist da etapa.
        - `id` integer — ID do item de checklist.
        - `name` string — Texto do item.
        - `info` string, nullable — Orientação adicional do item.
        - `funnel_step_id` integer — ID da etapa dona do item.
        - `required` boolean — Indica se o item impede a saída da etapa enquanto não for marcado.
        - `order` integer — Posição do item na lista.
    - `tags` object[] — Etiquetas do funil que atenderam ao filtro.
      - `id` integer — ID da etiqueta.
      - `name` string — Nome da etiqueta.
      - `color` string — Cor da etiqueta em hexadecimal.
      - `project_funnel_id` integer — ID do funil dono da etiqueta.
    - `funnel_status` object[] — Status do funil que atenderam ao filtro.
      - `id` integer — ID do status.
      - `name` string — Nome do status.
      - `color` string — Cor do status em hexadecimal.
      - `project_funnel_id` integer — ID do funil dono do status.

## Changes

- **2026-08-24** `3c590152d5b5` — 5 breaking, 2 warning, 2 info
  - the `funnels/items/form_id` response's property type changed from no type to `integer` for status `200`
  - the `funnels/items/funnel_status/items/color` response's property format changed from `color` to no format for status `200`
  - the `funnels/items/steps/items/checklists/items/info` response's property type changed from no type to `string` for status `200`
  - the `funnels/items/steps/items/form_id` response's property type changed from no type to `integer` for status `200`
  - …5 more
- **2026-08-19** `a7c4c54005a5` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2026-08-19** `d6832ed1714a` — 2 info
  - added the new optional `query` request parameter `id`
  - added the new optional `query` request parameter `search`
- **2026-08-19** `d85127746782` — 2 info
  - api tag `Etapas` added
  - api tag `get-available-steps` removed

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/get-available-steps/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-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/8c9bac94e5ad/schema)