--- title: "Retorna os dados das pessoas" method: GET path: "/pessoas" tags: ["Pessoas"] --- # Retorna os dados das pessoas `GET /pessoas` > 🔒 **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.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)