---
title: "Lista pessoas."
method: GET
path: "/v3/cadastros/pessoas"
tags: ["Pessoas"]
---

# Lista pessoas.

`GET /v3/cadastros/pessoas`

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

Retorna uma lista paginada de pessoas cadastradas no sistema. É possível filtrar por idpessoa, nome, documento, telefone ou e-mail.

## Query parameters

- `idpessoa` integer
- `nome` string
- `documento` string
- `telefone` string
- `email` string
- `pagina` integer
- `registros_por_pagina` integer

## Response `200`

Lista de pessoas retornada com sucesso.

- ListagemPessoasResponse
  - `status` string
  - `code` integer
  - `data` object
    - `dados` PessoaDTO[]
      - `idpessoa` integer
      - `idpessoaLegado` string
      - `codigointerno` string
      - `ativoLogin` boolean
      - `nome` string
      - `documento` string
      - `documentoTipo` string
      - `rg` string
      - `rgOrgaoEmissor` string
      - `rgDataEmissao` string
      - `dataNasc` string
      - `sexo` string
      - `nacionalidade` string
      - `email` string
      - `telefone` string
      - `celular` string
      - `cep` string
      - `idpais` integer
      - `pais` string
      - `idestado` integer
      - `estado` string
      - `idcidade` integer
      - `cidade` string
      - `idlogradouro` integer
      - `logradouro` string
      - `endereco` string
      - `bairro` string
      - `numero` string
      - `complemento` string
      - `naturalidade` string
      - `profissao` string
      - `rendaFamiliar` number
      - `observacoes` string
      - `estadoCivil` integer
      - `dataCasamento` string
      - `filiacaoPai` string
      - `filiacaoMae` string
      - `inscEstadual` string
      - `inscMunicipal` string
      - `sinalizadorJuridico` boolean
      - `dataPrimeiraHabilitacaoCnh` string
      - `dataFimValidadeCnh` string
      - `dataCad` string
      - `tags` object[]
        - `idtag` integer
        - `nome` string
      - `idclassificacao` integer
      - `trabalhoNomeEmpresa` string
      - `trabalhoCep` string
      - `trabalhoIdestado` integer
      - `trabalhoEstado` string
      - `trabalhoIdcidade` integer
      - `trabalhoCidade` string
      - `trabalhoEndereco` string
      - `trabalhoBairro` string
      - `trabalhoNumero` string
      - `complementoTrabalho` string
      - `trabalhoTelefone` string
      - `idlogradouroTrabalho` integer
      - `logradouroTrabalho` string
    - `total` integer
    - `pagina` integer
    - `registros_por_pagina` integer

## Other responses

- `400` — Parâmetros inválidos.
- `500` — Erro inesperado.

---

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