---
title: "Listar leads"
method: GET
path: "/leads"
tags: ["Leads"]
---

# Listar leads

`GET /leads`

Lista leads com base nos parâmetros fornecidos.

## Query parameters

- `page` number
- `size` number
- `search` string
- `name` string
- `email` string
- `phone` string
- `orderBy` 'createdAtDesc' | 'nameAsc' — Ordenação da lista de leads
- `createdAtStart` string, date-time
- `agentId` string
- `capture` 'completed' | 'partial'

## Response `200`

Successful response

- object — Página de registros
  - `data` object[], required — Lista de registros da página
    - `id` string, required — Identificador do lead
    - `agentId` string, nullable — Assistente que capturou o lead
    - `name` string, nullable — Nome
    - `email` string, nullable — Email
    - `phone` string, nullable — Telefone
    - `company` string, nullable — Empresa
    - `site` string, nullable — Site
    - `custom` object — Campos
    - `utm` object — Informações de rastreamento UTM
      - `source` string, nullable — Fonte (`utm_source`)
      - `medium` string, nullable — Meio (`utm_medium`)
      - `campaign` string, nullable — Campanha (`utm_campaign`)
      - `content` string, nullable — Conteúdo (`utm_content`)
      - `term` string, nullable — Termo (`utm_term`)
    - `capture` 'completed' | 'partial' — Status da captura de dados do lead
    - `workspaceId` string, required — Identificador do workspace associado
    - `createdAt` string, date-time — Data de criação
    - `updatedAt` string, date-time — Data da última atualização
  - `meta` object, required — Metadados da página
    - `total` number, required — Total de registros
    - `page` number, required — Número da página atual
    - `size` number, required — Quantidade de registros da página
    - `first` number, required — Primeira página
    - `last` number, required — Última página
    - `next` number, nullable, required — Próxima página
    - `previous` number, nullable, required — Página anterior

## Other responses

- `default` — Error response

## Changes

- **2026-08-11** `e86f2f8dff55` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-11T04:04:14.802Z` to `2026-08-11T23:01:54.801Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-11T04:04:14.803Z` to `2026-08-11T23:01:54.801Z` for the status `200`
- **2026-08-11** `66aaaea086cc` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-10T09:03:35.361Z` to `2026-08-11T04:04:14.802Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-10T09:03:35.361Z` to `2026-08-11T04:04:14.803Z` for the status `200`
- **2026-08-10** `53961f5192d9` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-09T14:02:22.995Z` to `2026-08-10T09:03:35.361Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-09T14:02:22.995Z` to `2026-08-10T09:03:35.361Z` for the status `200`
- **2026-08-09** `b7d29b0c0204` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-08T19:02:26.458Z` to `2026-08-09T14:02:22.995Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-08T19:02:26.458Z` to `2026-08-09T14:02:22.995Z` for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/rdstationmentoria/apis/agents/changes/leads/get.md)

---

[API](https://skmtc.dev/rdstationmentoria/apis/agents.md) · [All operations](https://skmtc.dev/rdstationmentoria/apis/agents/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rdstationmentoria/agents/revisions/e86f2f8dff55/schema)