---
title: "Retorna a lista de pré-cadastros com filtro de indicador"
method: GET
path: "/v3/comercial/precadastros"
tags: ["Pré-cadastro"]
---

# Retorna a lista de pré-cadastros com filtro de indicador

`GET /v3/comercial/precadastros`

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

Endpoint para consultar pré-cadastros conforme indicador.

## Query parameters

- `indicador` string, required
- `registros_por_pagina` integer
- `pagina` integer
- `sort` string
- `order` 'ASC' | 'DESC'

## Response `200`

Lista de pré-cadastros retornada com sucesso.

- PrecadastrosResponse — Objeto de resposta para a listagem de pré-cadastros.
  - `status` string — Situação da requisição
  - `code` integer — Código da requisição
  - `pagination` PaginacaoV3 — Informações de paginação para resultados paginados.
    - `pagina` integer
    - `registros` integer
    - `totalRegistros` integer
    - `totalPaginas` integer
  - `filter` object[] — Informações dos filtros realizados.
    - `campo` string
    - `valor` string
  - `order` OrderV3 — Informações da ordenação para os resultados.
    - `campo` string
    - `valor` string
  - `data` object[]
    - `idprecadastro` integer — Identificador do pré-cadastro
    - `dataCad` string — Data de cadastro do pré-cadastro
    - `idSituacao` integer — Identificador da situação do pré-cadastro
    - `condicaoAprovada` string — Condição de aprovação
    - `idEmpreendimento` integer — Identificador do empreendimento
    - `idCorretor` integer — Identificador do corretor
    - `idEmpresa` integer — Identificador da empresa
    - `idUsuarioCorrespondente` integer — Identificador do usuário correspondente
    - `idPessoa` integer — Identificador da pessoa
    - `valorAvaliacao` string — Valor de avaliação do imóvel
    - `valorAprovado` string — Valor aprovado de financiamento
    - `valorSubsidio` string — Valor do subsídio
    - `valorTotal` string — Valor total do negócio
    - `utilizarFgts` string — Indica se o FGTS será utilizado
    - `valorFgts` string — Valor do FGTS utilizado
    - `saldoDevedor` string — Saldo devedor
    - `prazo` integer — Prazo do financiamento
    - `observacoes` string — Observações relevantes
    - `tabela` string — Tabela de financiamento utilizada
    - `valorPrestacao` string — Valor da prestação inicial
    - `cartaCredito` string — Detalhes da carta de crédito
    - `vencimentoAprovacao` string — Data de vencimento da aprovação
    - `idMotivoReprovacao` integer — Identificador do motivo de reprovação
    - `descricaoMotivoReprovacao` string — Descrição do motivo de reprovação
    - `idMotivoCancelamento` integer, nullable — Identificador do motivo de cancelamento
    - `descricaoMotivoCancelamento` string, nullable — Descrição do motivo de cancelamento
    - `slaVencimento` string — Prazo de vencimento do SLA
    - `idAnapro` string, nullable — Identificador do Anapro
    - `vencimento` string, nullable — Data de vencimento
    - `dataEmailVencCorretor` string, nullable — Data de envio de e-mail de vencimento ao corretor
    - `idBloco` integer, nullable — Identificador do bloco
    - `idEtapa` integer, nullable — Identificador da etapa
    - `idUnidade` integer, nullable — Identificador da unidade
    - `idImobiliaria` integer — Identificador da imobiliária
    - `classificacao` string, nullable — Classificação do pré-cadastro
    - `idLancamento` integer, nullable — Identificador do lançamento
    - `idPrecadastroLancamento` integer, nullable — Identificador do pré-cadastro de lançamento
    - `situacaoSerasa` string — Situação no Serasa
    - `imprimiuEtiqueta` string — Indica se a etiqueta foi impressa
    - `tipo` string — Tipo de pré-cadastro
    - `idSituacaoAnterior` integer — Identificador da situação anterior do pré-cadastro
    - `dataUltimaAlteracaoSituacao` string — Data da última alteração de situação
    - `dataModificacao` string — Data da última modificação do registro
    - `idMotivoTroca` integer, nullable — Identificador do motivo da troca
    - `descricaoMotivoTroca` string, nullable — Descrição do motivo da troca
    - `idIntencaoCompra` integer, nullable — Identificador da intenção de compra
    - `statusAnaliseSubsidio` string — Status da análise de subsídio
    - `codigoInterno` string — Código interno de controle
    - `mensagemAnaliseSubsidio` string — Mensagem da análise de subsídio

## Other responses

- `400` — Requisição inválida (Ex: Parâmetro obrigatório ausente).
- `403` — Token de acesso expirado/inválido.

---

[API](https://skmtc.net/cvcrm/apis/clientes.md) · [All operations](https://skmtc.net/cvcrm/apis/clientes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cvcrm/clientes/revisions/42bf5add8bf3/schema)