---
title: "Listar funis de projeto"
method: GET
path: "/api/management/get-project-funnels"
tags: ["project-funnels", "Funis"]
---

# Listar funis de projeto

`GET /api/management/get-project-funnels`

Lista os funis da conta na ordem de exibição definida pelo usuário, cada um com a área de negócio e as contagens de projetos, etapas, etiquetas, status e anexos. **Só retorna os funis ativos por padrão** — envie `filter[condition]=inactive` para os inativos e `filter[trashed]=with` ou `only` para incluir os arquivados. Funis que o usuário autenticado não tem permissão de ver são omitidos da lista. Ver [Criar e configurar um funil](https://docs.olie.ai/guides/funnels/creating-funnels) e [Filtros básicos](https://docs.olie.ai/api-reference/general/basic-filters).

## Query parameters

- `search` string
- `id` string
- `filter[condition]` string
- `filter[name]` string
- `filter[business_area.id]` string
- `filter[trashed]` string

## Response `200`

Sucesso

- object
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `project_funnels` object[], required — Funis visíveis ao usuário, na ordem de exibição.
    - `id` integer — ID do funil.
    - `name` string — Nome do funil.
    - `prefix` string, nullable — Prefixo usado no código dos projetos do funil.
    - `condition` 'active' | 'inactive' — Situação do funil.
    - `allow_multi_step` boolean — Indica se o projeto pode ocupar várias etapas ao mesmo tempo.
    - `project_term` object, nullable — Vocabulário do funil para o termo 'projeto'.
    - `show_cost_info` boolean — Indica se as informações de custo aparecem no funil.
    - `allow_execution` boolean — Indica se o funil permite cronometrar execução.
    - `business_area` object, nullable — Área de negócio do funil.
      - `id` integer — ID da área de negócio.
      - `name` string — Nome da área de negócio.
    - `business_area_id` integer, nullable — ID da área de negócio do funil.
    - `form_id` integer, nullable — ID do formulário de vínculo do funil.
    - `projects_count` integer — Quantidade de projetos vinculados ao funil.
    - `steps_count` integer — Quantidade de etapas do funil.
    - `tags_count` integer — Quantidade de etiquetas do funil.
    - `status_count` integer — Quantidade de status do funil.
    - `attachments_count` integer — Quantidade de anexos do funil.
    - `created_at` string, date-time — Data de criação.
    - `updated_at` string, date-time — Data da última alteração.
    - `deleted_at` string, date-time, nullable — Data de arquivamento, quando o funil está arquivado.

## Changes

- **2026-08-24** `3c590152d5b5` — 4 breaking, 2 warning, 7 info
  - the response property `project_funnels/items/business_area` became nullable for the status `200`
  - the response property `project_funnels/items/business_area_id` became nullable for the status `200`
  - the response property `project_funnels/items/form_id` became nullable for the status `200`
  - the response property `project_funnels/items/prefix` became nullable for the status `200`
  - …9 more
- **2026-08-19** `f521a8dfa4f7` — 6 info
  - added the new optional `query` request parameter `filter[business_area.id]`
  - added the new optional `query` request parameter `filter[condition]`
  - added the new optional `query` request parameter `filter[name]`
  - added the new optional `query` request parameter `filter[trashed]`
  - …2 more
- **2026-08-19** `f3efb100a3fc` — 2 info
  - api tag `Funis` added
  - api tag `get-project-funnels` removed

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