---
title: "Retorna os dados das pessoas"
method: GET
path: "/pessoas"
tags: ["Pessoas"]
---

# Retorna os dados das pessoas

`GET /pessoas`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/cvdw`
- URL: `https://integracao.cvcrm.com.br/api/v1/cvdw/pessoas`
- Auth: none declared. Required headers: `email`, `token`

> 🔒 **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 valores das pessoas 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`

Corpo de resposta dos dados das pessoas

- object: Dados de pessoas
  - `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` PessoasRetorno[]
    - `referencia` string: Código identificador
    - `referencia_data` string: Data de referência
    - `ativo` string: Informa se está ativo ou não
    - `idpessoa` integer: Código identificador da pessoa
    - `idpessoa_int` string: Código identificador da pessoa (Código Interno)
    - `idpessoa_legado` integer: Código identificador da pessoa (legado)
    - `data_cad` string: Data de cadastro
    - `ativo_painel` string: Informa se a pessoa está ativa
    - `ativo_login` string: Informa se a pessoa te login ativo
    - `situacao` string: Informa a situação da Pessoa (Cliente; Não cliente; Prospect)
    - `validado` string: Informa se a pessoa está validada
    - `documento_tipo` string: Tipo do documento
    - `documento` string: Documento
    - `pessoa_estrangeira` string: Informa se pessoa estrangeira
    - `nome` string: Nome
    - `reconhecimento_firma` string: Reconhecimento de firma
    - `sexo` string: Sexo da pessoa (Feminino; Masculino; Não desejo informar)
    - `data_nasc` string: Data de nascimento
    - `estado_civil` string: Estado civil
    - `data_casamento` string: Data de casamento
    - `pacto_antenupcial_livro` string: Informação do Pacto antenupcial, Livro
    - `folha` string: Folha
    - `cartorio` string: Cartório
    - `pais` string: País
    - `naturalidade` string: Naturalidade
    - `possui_dependentes` string: Informa se possui dependentes
    - `quantidade_dependentes` integer: Quantidade de dependentes
    - `possui_procuracao` string: Informa se possui procuração
    - `possui_pacto_antenupcial` string: Informa se possui pacto antenupcial
    - `menor_nao_emancipado` string: Informa se é menor e não emancipado
    - `grau_instrucao` string: Grau de instrução
    - `renda_familiar` string: Renda familiar
    - `marketing_pos_venda` string: Marketing Pós-venda
    - `rg` string: Número do RG
    - `rg_orgao_emissor` string: Orgão emissor do RG
    - `rg_data_emissao` string: Data de emissão do RG
    - `rne` string: Número do RNE
    - `rne_orgao_emissor` string: Orgão emissor do RNE
    - `rne_data_emissao` string: Data de emissão do RNE
    - `passaporte` string: Número do passaporte
    - `passaporte_orgao_emissor` string: Orgão emissor do passaporte
    - `passaporte_data_emissao` string: Data de emissão do passaporte
    - `cnh` string: Número da CNH
    - `cnh_orgao_emissor` string: Orgão emissor da CNH
    - `data_primeira_habilitacao_cnh` string: Data da primeira habilitação da CNH
    - `data_fim_validade_cnh` string: Data de validade da CNH
    - `cnh_data_emissao` string: Data de emissão da CNH
    - `rnm` string: Número do RNM
    - `rnm_orgao_emissor` string: Orgão emissor do RNM
    - `rnm_data_emissao` string: Data de emissão do RNM
    - `filiacao_mae` string: Filiação Mãe/2
    - `filiacao_pai` string: Filiação Pai/1
    - `razao_social` string: Razão Social
    - `segmento_razao` string: Segmento/Ramo
    - `razao_social_anterior` string: Razão social anterior
    - `sucessao` string: Sucessão
    - `forma_constituicao` string: Forma de constituição
    - `data_constituicao` string: Data de constituição
    - `numero_junta_comercial` string: Número da junta comercial
    - `classificacao` string: Classificação da pessoa
    - `insc_estadual` string: Inscrição estadual
    - `insc_municipal` string: Inscrição municipal
    - `cep` string: CEP
    - `logradouro` string: Logradou
    - `endereco` string: Endereço
    - `bairro` string: Bairro
    - `numero` string: Número
    - `complemento` string: Complemento
    - `estado` string: Estado
    - `cidade` string: Cidade
    - `endereco_pais` string: País
    - `tipo_residencia` string: Tipo da resdência
    - `reside_com` string: Com quem Reside
    - `valor_aluguel` string: Valor de aluguel
    - `tempo_residencia` integer: Tempo de residência (mês)
    - `tipo_correspondencia` string: Tipo de correspondência
    - `politicamente_exposta` string: Pessoa politicamente exposta
    - `ppe_cargo` string: Cargo/Função
    - `ppe_exercicio` string: Período de exercício
    - `suspeito` string: Pessoa contemplada na lista de indivíduos suspeitos/envolvidos em lavagem de dinheiro e financiamento ao terrorismo
    - `residente_municipio_fronteira` string: Pessoa residente em município de faixa de fronteira
    - `relacionamento_ppe` string: Relacionamento com um PPE
    - `relacionamento_ppe_nome` string: Nome do relacionamento
    - `relacionamento_ppe_parentesco` string: Parentesco do relacionamento
    - `relacionamento_ppe_cargo` string: Cargo/Função do relacionamento
    - `relacionamento_ppe_exercicio` string: Período de exercício do relacionamento
    - `relacionamento_ppe_identificacao` string: Código identificador do relacionamento
    - `relacionamento_ppe_orgao_emissor` string: Orgão emissor do relacionamento
    - `relacionamento_ppe_data_nasc` string: Data de nascimento do relacionamento
    - `relacionamento_ppe_cpf` string: CPF do relacionamento
    - `numero_pis` string: Número do PIS
    - `observacoes` string: Observações

---

[API](https://skmtc.dev/cvcrm/apis/cvdw.md) - [All operations](https://skmtc.dev/cvcrm/apis/cvdw/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/cvdw/revisions/ca413a559002?raw)
