---
title: "List leads with filters"
method: GET
path: "/api/leads"
tags: ["Leads - Admin"]
---

# List leads with filters

`GET /api/leads`

## Query parameters

- `team_id` integer, nullable — Filter by attribution funnel (legacy single; matches Z_Leads.teams_id)
- `team_ids` integer[], nullable — Filter by one or more attribution funnels ('Fluxo de Atribuição') — matches leads attributed to any selected funnel (Z_Leads.teams_id), regardless of who owns them now. NOT owner membership.
- `stage` string, nullable
- `lead_stage` string, nullable
- `user_id` integer, nullable — Filter by user (legacy single)
- `user_ids` integer[], nullable — Filter by one or more users — matches leads owned by any of them
- `scope` string, nullable — 'mine' = role-aware board view: the caller's own leads, plus all team leads if the caller is a team leader
- `lost_reasons` string[], nullable — Filter lost leads by one or more lost_reason IDs
- `sort` string, nullable — Sort order: 'created_desc' (newest first) or 'created_asc' (oldest first)
- `date_start` string, nullable — Only leads created on/after this date (YYYY-MM-DD)
- `date_end` string, nullable — Only leads created on/before this date, inclusive (YYYY-MM-DD)
- `skip` integer
- `limit` integer

## Headers

- `x-api-token` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)