---
title: "Listar conversões do lead"
method: GET
path: "/leads/{idLead}/conversoes"
tags: ["Conversões do Lead"]
---

# Listar conversões do lead

`GET /leads/{idLead}/conversoes`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v4/comercial`
- URL: `https://integracao.cvcrm.com.br/api/v4/comercial/leads/{idLead}/conversoes`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-nas-apis-do-cv-crm-com-bearer-token)

Lista as conversões ativas do lead, paginadas. Ordenação padrão: `dataCad` decrescente
(mais recente primeiro).

Disponível para os painéis Gestor, Imobiliária e Corretor. Exige a permissão
`comercial|leads|2` no perfil do usuário. Corretor e Imobiliária só enxergam os leads
que atendem.

## Path parameters

- `idLead` integer, required

## Query parameters

- `page` integer
- `limit` integer
- `sort` 'dataCad' | 'conversao' | 'origem'
- `order` 'ASC' | 'DESC'
- `search` object

## Response `200`

Página de conversões do lead.

- object
  - `status` string
  - `code` integer
  - `data` object
    - `pagination` Paginacao
      - `total` integer: Total de conversões encontradas com os filtros aplicados.
      - `paginaAtual` integer: Página retornada.
      - `porPagina` integer: Quantidade de registros por página.
      - `totalPaginas` integer: Total de páginas (mínimo 1).
    - `items` LeadConversao[]
      - `idConversao` integer, required: Identificador do registro no histórico de conversões do lead.
      - `conversao` string, required: Nome da conversão.
      - `origem` string, nullable: Código de origem da conversão.
      - `midia` object, nullable: Mídia da conversão, ou `null` quando não informada.
        - `idMidia` integer: Identificador da mídia.
        - `nome` string, nullable: Nome da mídia.
      - `empreendimentos` object[], required: Empreendimentos associados à conversão.
        - `idEmpreendimento` integer: Identificador do empreendimento.
        - `nome` string: Nome do empreendimento.
      - `integracao` 'RD' | 'SS' | 'FB' | 'null', nullable: Integração de marketing da conversão. `null` nas conversões anteriores à v4 ou sem integração.
      - `idIntegracao` string, nullable: Identificador do lead na base da integração.
      - `idFormulario` integer, nullable: Identificador do formulário do Facebook cadastrado no CV.
      - `dataCadConversao` string, date-time, required: Data e hora da conversão, no formato `YYYY-MM-DD HH:MM:SS`.

## Other responses

- `400`: Parâmetros de listagem inválidos: `page` ou `limit` não inteiros, `sort` ou `order` fora dos valores aceitos, `search` mal formatado, com operador desconhecido ou com campo fora de `dataCad`, `integracao`, `origem`, `idMidia`.
- `401`: Token ausente, inválido ou expirado, ou painel não autorizado para esta rota.
- `403`: O perfil do usuário não tem a permissão `comercial|leads|2`.
- `404`: Lead inexistente, inativo ou fora do escopo do painel autenticado (Corretor e Imobiliária só acessam os leads que atendem).
- `429`: Limite de requisições da API excedido. Repita a chamada depois.
- `500`: Falha inesperada ao listar as conversões do lead.

---

[API](https://skmtc.dev/cvcrm/apis/convers-es-do-lead.md) - [All operations](https://skmtc.dev/cvcrm/apis/convers-es-do-lead/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/convers-es-do-lead/revisions/c430d729ba8f?raw)