Conversões do Lead

Listar conversões do lead

🔒 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)

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.

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

Path parameters

idLeadinteger required

Identificador do lead.

Query parameters

pageinteger

Página desejada.

limitinteger

Quantidade de registros por página. Valores acima de 100 são limitados a 100.

sort'dataCad' | 'conversao' | 'origem'

Campo de ordenação. Outro valor retorna 400.

order'ASC' | 'DESC'

Direção da ordenação.

searchobject

Filtros no formato search[operador|campo]=valor.

Campos aceitos: dataCad, integracao, origem, idMidia. Outro campo retorna 400.

Operadores: equal, notEqual, greaterThan, greaterThanOrEqual, lessThan, lessThanOrEqual, in, notIn, like, null, notNull.

Exemplos:

  • search[equal|integracao]=FB
  • search[greaterThanOrEqual|dataCad]=2026-07-01

Response

Página de conversões do lead.

statusstring
codeinteger

Example response

{
  "status": "success",
  "code": 200,
  "data": {
    "pagination": {
      "total": 3,
      "paginaAtual": 1,
      "porPagina": 20,
      "totalPaginas": 1
    },
    "items": [
      {
        "idConversao": 55210,
        "conversao": "LP Lançamento Empreendimento X",
        "origem": "FB",
        "midia": {
          "idMidia": 12,
          "nome": "Facebook Ads"
        },
        "empreendimentos": [
          {
            "idEmpreendimento": 301,
            "nome": "Residencial X"
          }
        ],
        "integracao": "FB",
        "idIntegracao": "fb-lead-99182",
        "idFormulario": 771,
        "dataCadConversao": "2026-07-20 14:32:00"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.