---
title: "List funnels"
method: GET
path: "/funnels"
---

# List funnels

`GET /funnels`

## Request

- Base URL: `https://gringofunnels.com/api/v1`
- URL: `https://gringofunnels.com/api/v1/funnels`
- Auth: HTTP bearer

## Response `200`

Funnels for the authenticated workspace

- object
  - `data` Funnel[], required
    - `id` string, uuid, required
    - `name` string, required
    - `type` string, required
    - `slug` string, required
    - `status` 'ativo' | 'pausado' | 'rascunho' | 'arquivado', required
    - `updatedAt` string, date-time, required
    - `stepCount` integer, required
    - `visits` integer, required
    - `leads` integer, required
    - `conversion` number, nullable, required: Measured conversion fraction, or null when aggregate lead and view totals cannot establish the same deduplicated visitor cohort. Null is not zero; do not derive a replacement percentage from the operational totals.
    - `revenueBrl` number, required

## Other responses

- `401`: Missing or invalid API key
- `429`: Tenant and endpoint allowance exceeded (600 requests per 60 seconds)
- `503`: A required API protection or dependency is unavailable

---

[API](https://skmtc.dev/gringofunnels/apis/gringo-funnels-api.md) · [All operations](https://skmtc.dev/gringofunnels/apis/gringo-funnels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gringofunnels/apis/gringo-funnels-api/revisions/b57b5e365b56?raw)