--- title: "Retorna os dados das simulações" method: GET path: "/simulacoes" tags: ["Simulações"] --- # Retorna os dados das simulações `GET /simulacoes` > 🔒 **Autenticação necessária** > > Esta API utiliza autenticação via **e-mail e token** nos headers da requisição. > Consulte o tutorial completo antes de fazer sua primeira chamada: > [Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-apis-cvcrm-email-token) Esta api retorna os dados das simulações a partir dos filtros solicitados, caso deseje saber o que cada campo representa basta ir no schema. ## Query parameters - `pagina` integer - `registros_por_pagina` integer - `a_partir_referencia` integer - `a_partir_data_referencia` string - `ate_data_referencia` string ## Headers - `email` string, required - `token` string, required ## Response `200` Simulações - object — Dados simulação - `pagina` integer — Página atual do retorno dos registros - `registros` integer — Quantidade de registro da página, máximo 500 registros - `total_de_registros` integer — Total de registros encontrados - `total_de_paginas` integer — Total de páginas encontradas - `dados` Simulacoes[] - `referencia` string — Código identificador da simulação - `referencia_data` string — Data de referência - `ativo` string — Informa se está ativo ou não - `idsimulacao` integer — Código identificador da simulação - `data_cad` string — Data de cadastro da simulação - `data_vencimento` string — Data de vencimento da reserva - `data_email_venc_corretor` string — Data e hora de envio do e-mail de vencimento para corretor - `situacao_simulacao` string — Situação da simulação - `idsituacao` integer — Código identificador da situação da simulação - `idusuario` integer — Código identificador do usuário administrativo que criou a simulação - `idusuario_imobiliaria` integer — Identificador do usuário da imobiliária que cadastrou a simulação - `idreserva` integer — Identificador da reserva vinculada a simulação - `idcorretor` integer — Identificador do corretor vinculado a simulação - `corretor` string — Nome do corretor vinculado a simulação - `idimobiliaria` integer — Identificador da imobiliária vinculada a simulação - `imobiliaria` string — Nome da imobiliária vinculada a simulação - `lead` string — Nome do lead vinculado a simulação - `idempreedimento` integer — Código identificador do empreendimento - `empreendimento` string — Nome do empreendimento vinculado a simulação - `idetapa` integer — Código identificador da etapa - `etapa` string — Nome da etapa vinculada a simulação - `idbloco` integer — Código identificador do bloco - `bloco` string — Nome do bloco vinculado a simulação - `idunidade` integer — Código identificador da unidade - `unidade` string — Nome da unidade vinculada a simulação - `idtabela` integer — Código identificador da tabela de preço - `data_alteracao_situacao` string — Data e hora de alteração da situação - `quantidade_mensagens` integer — Quantidade de mensagens enviadas - `solicitacao_aprovacao` string — Informa a solicitação de aprovação da simulação - `condicao_aprovada` string — Informa a aprovação da simulação - `data_primeira_aprovacao` string — Data e hora de alteração da primeira aprovação - `data_entrega` string — Data de entrega - `data_base_calculo_juros` string — Data base para cálculo de juros - `descricao_motivo_reprovacao` string — Descrição do motivo da reprovação da simulação - `idmotivo_cancelamento` integer — Código identificador do motivo do cancelamento - `descricao_motivo_cancelamento` string — Descrição do motivo de cancelamento da simulação - `juros_vpl` number — Percentual de juros trabalhado no VPL - `juros_vpl_apos_entrega` number — Percentual de juros trabalhado no VPL após a entrega - `juros_futuro` number — Percentual de juros futuro da simulação - `juros_vpl_fixa_adicional` number — Percentual adicional dos juros trabalhado no VPL para séries fixas - `renda_familiar` number — Renda familiar - `sla_vencimento` string — Data de vencimento do sla - `data_condicao_aprovada` string — Data de aprovação da simulação - `idusuario_condicao_aprovada` integer — Código identificador do usuário administrativo que aprovou a simulação - `idtabela_condicao_aprovada` integer — Tabela aprovada na simulação - `juros_condicao_aprovada` number — Juros da condição aprovada - `juros_apos_entrega_condicao_aprovada` number — Percentual de juros trabalhado no VPL após a entrega aprovado - `aprovacao_vpl_valor` number — Valor do VPL aprovado na simulação - `aprovacao_vpl` number — VPL aprovado na simulação - `aprovacao_absoluto` number — Valor absoluto aprovado na simulação - `aprovacao_absoluto_percentual` number — Percentual absoluto aprovado na simulação - `aprovacao_margem` number — Margem de aprovação da simulação - `desconto` number — Valor do desconto - `idalcada` integer — Código identificador da alçada - `percentual_custa_escrituracao` number — Percentual de custas de escrituração - `juros` string — Informa se vai ter juros - `juros_embutido` string — Informa se vai ter juros embutido - `quantidade_parcelas_min` integer — Quantidade de parcelas mínima - `quantidade_parcelas_max` integer — Quantidade de parcelas máxima - `data_base_juros_futuro_cadastro` string — Data base para cálculo de juros futuro - `data_base_calculo_pv` string — Data base para cálculo de valor PV - `data_base_calculo_pv_alterada` string — Informa se a data base para cálculo de valor PV foi modificada - `data_contrato_aprovacao_comercial` string — Data de contrato da simulação - `usuario_preencheu_data_contrato` string — Informa se o usuário preencheu a data de contrato - `porcentagem_total_comissao` number — Percentual total da comissão - `pagamento_total_comissao` string — Pagamento total da comissão - `porcentagem_total_premiacao` number — Porcetagem total da premiação - `pagamento_total_premiacao` string — Pagamento total da premiação - `adimplencia_premiada` number — Valor da adimplência premiada - `ignorar_validacao_adimplencia_premiada` string — Informa se vai ignorara validação de adimplência premiada - `calculo_juros_price_baseado_em` string — Informa qual a data base que será usada para cálculo de juros - `porcentagem_total_contrato` number — Porcentagem máxima de comissão no contrato - `pagamento_total_contrato` string — Tipo de cálculo para máxima comissão no contrato - `porcentagem_total_fora_contrato` number — Porcentagem máxima da comissão fora do contrato - `pagamento_total_fora_contrato` string — Tipo de cálculo para máxima comissão fora do contrato - `idtipovenda` integer — Código identificador do tipo de venda da simulação - `data_modificacao` string - `idprecadastro` integer — Código identificador do pré-cadastro vinculado a simulação - `idlead` integer — Código identificador do lead da simulação - `valor_contrato` number — Valor do contrato - `valor_presente` number — Valor do contrato - `espaco_complementar` object — Espaços complementar da simulação - `idespaco` integer — Código identificador do espaço complementar - `condicoes_pagamento` object — Condições de pagamento da simulação - `referencia` integer — Código identificador da condição de pagamento - `idsimulacoescondicoes` integer — Código identificador da condição de pagamento - `nome` string — Nome da série de pagamento - `idserie` integer — Código identificador da série de pagamento - `qtd_parcelas` string — Quantidade de parcelas da série de pagamento - `valor` number — Valor da série de pagamento - `valor_com_juros` number — Valor com juros da série de pagamento - `vencimento` string — Vencimento da série de pagamento - `idportador` integer — Código identificador do portador da série - `idindexador` integer — Código identificador do indexador da série - `data_base_juros_futuro` string — Data base para cálculo do juros futuro - `juros_futuro` number — Juros futuro --- [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)