# Consulta CNH por CPF Estendida

A consulta de CNH por CPF Estendida, traz informações sobre o condudutior e sua cnh através do cpf informado.

- **Identificador:** `pessoas/consulta-cnh-por-cpf-estendida`
- **Categoria:** Documentos e biometria
- **Audiência:** PF
- **Endpoint:** `POST /api/v1/{tenant}/pessoas/consulta-cnh-por-cpf-estendida`
- **Preço de tabela:** R$ 1,560 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/pessoas/consulta-cnh-por-cpf-estendida

## Quando usar

Descrição

O serviço de Consulta CNH por CPF Estendida retorna informações oficiais detalhadas sobre a Carteira Nacional de Habilitação (CNH) de um condutor a partir do CPF informado.

Além dos dados cadastrais básicos, são apresentados status da habilitação (ativa, suspensa ou cassada), data de validade, categoria, número do documento, data de emissão, órgão expedidor e informações relacionadas a eventuais restrições ou penalidades aplicadas ao condutor.

Essa consulta auxilia em processos de verificação de identidade, análise cadastral e validação da elegibilidade para condução de veículos.

## Parâmetros (corpo JSON)

| Campo | Obrigatório | Descrição |
|---|---|---|
| `document` | sim | CPF da pessoa, com ou sem máscara. |

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `status` | número |
| `status_mensagem` | texto |
| `data.cnh.renach` | texto |
| `data.cnh.numeroRegistro` | texto |
| `data.cnh.numeroFormulario` | texto |
| `data.cnh.dataCadastramento` | data |
| `data.cnh.dataPrimeiraHabilitacao` | data |
| `data.cnh.ufPrimeiraHabilitacao` | texto |
| `data.cnh.dataUltimaEmissao` | data |
| `data.cnh.dataValidade` | data |
| `data.cnh.categoriaAtual` | texto |
| `data.cnh.categoriaAutorizada` | texto |
| `data.cnh.categoriaRebaixada` | texto |
| `data.cnh.situacao` | texto |
| `data.cnh.descricaoSituacao` | texto |
| `data.cnh.situacaoAnterior` | texto |
| `data.cnh.descricaoSituacaoAnterior` | texto |
| `data.cnh.ufHabilitacaoAtual` | texto |
| `data.cnh.quadroObservacoes` | texto |
| `data.cnh.quantidadeImpedimentos` | número |
| `data.cnh.numeroListaImpedimento` | texto |
| `data.cnh.numeroPgu` | texto |
| `data.cnh.permissionario` | número |
| `data.cnh.cancelamento` | texto |
| `data.cnh.codigoTransacaoUltimaAtualizacao` | número |
| `data.cnh.dataTransacaoUltimaAtualizacao` | data |
| `data.cpf` | texto |
| `data.dataNascimento` | data |
| `data.descricaoLocalidadeNascimento` | texto |
| `data.descricaoNacionalidade` | texto |
| `data.descricaoSexo` | texto |
| `data.localidadeNascimento` | texto |
| `data.nacionalidade` | número |
| `data.nome` | texto |
| `data.nomeMae` | texto |
| `data.nomePai` | texto |
| `data.numeroFormularioCnh` | texto |
| `data.numeroRegistro` | texto |
| `data.restricoesMedicas` | texto |
| `data.sexo` | número |
| `data.ufDominio` | texto |
| `data.ufSolicitanteTransferencia` | texto |
| `data.motivoRequerimento[]` | texto |
| `data.descricaoMotivoRequerimento[]` | texto |
| `data.motivoRequerimentoPid[]` | texto |
| `data.descricaoMotivoRequerimentoPid[]` | texto |
| `data.cursos.tpp.classificacao` | texto |
| `data.cursos.tpp.descricao` | texto |
| `data.cursos.tpp.data` | texto |
| `data.cursos.tpp.uf` | texto |
| `data.cursos.te.classificacao` | texto |
| `data.cursos.te.descricao` | texto |
| `data.cursos.te.data` | texto |
| `data.cursos.te.uf` | texto |
| `data.cursos.tcp.classificacao` | texto |
| `data.cursos.tcp.descricao` | texto |
| `data.cursos.tcp.data` | texto |
| `data.cursos.tcp.uf` | texto |
| `data.cursos.tve.classificacao` | texto |
| `data.cursos.tve.descricao` | texto |
| `data.cursos.tve.data` | texto |
| `data.cursos.tve.uf` | texto |
| `data.cursos.tci.classificacao` | texto |
| `data.cursos.tci.descricao` | texto |
| `data.cursos.tci.data` | texto |
| `data.cursos.tci.uf` | texto |
| `data.cursos.tmf.classificacao` | texto |
| `data.cursos.tmf.descricao` | texto |
| `data.cursos.tmf.data` | texto |
| `data.cursos.tmf.uf` | texto |
| `data.cursos.tmt.classificacao` | texto |
| `data.cursos.tmt.descricao` | texto |
| `data.cursos.tmt.data` | texto |
| `data.cursos.tmt.uf` | texto |
| `data.cursos.reciclagemInfrator.modalidade` | texto |
| `data.cursos.reciclagemInfrator.descricao` | texto |
| `data.cursos.reciclagemInfrator.data` | texto |
| `data.cursos.reciclagemInfrator.uf` | texto |
| `data.cursos.atualizacaoRenovacaoCnh.modalidade` | texto |
| `data.cursos.atualizacaoRenovacaoCnh.descricao` | texto |
| `data.cursos.atualizacaoRenovacaoCnh.data` | texto |
| `data.cursos.atualizacaoRenovacaoCnh.uf` | texto |
| `data.endereco.logradouro` | texto |
| `data.endereco.numero` | texto |
| `data.endereco.complemento` | texto |
| `data.endereco.bairro` | texto |
| `data.endereco.municipio` | texto |
| `data.endereco.descricaoMunicipio` | texto |
| `data.endereco.uf` | texto |
| `data.endereco.cep` | texto |
| `data.documento.numero` | texto |
| `data.documento.tipo` | número |
| `data.documento.descricao` | texto |
| `data.documento.orgaoExpedidor` | texto |
| `data.documento.ufExpedidor` | texto |
| `data.habilitacaoEstrangeira.identificacao` | texto |
| `data.habilitacaoEstrangeira.paisOrigem` | texto |
| `data.habilitacaoEstrangeira.descricaoPaisOrigem` | texto |
| `data.habilitacaoEstrangeira.dataValidade` | texto |
| `data.habilitacaoEstrangeira.registroNacionalEstrangeiro` | texto |
| `data.pid.numeroFormulario` | texto |
| `data.pid.numeroFormularioCnhBase` | texto |
| `data.pid.dataValidade` | texto |
| `data.pid.ufExpedicao` | texto |
| `data.pid.situacao` | texto |
| `data.pid.motivoRequerimento[]` | texto |
| `data.pid.descricaoMotivoRequerimento[]` | texto |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Consulta CNH por CPF Estendida",
  "query_slug": "consulta-cnh-por-cpf-estendida",
  "data": {
    "status": 0,
    "status_mensagem": "texto",
    "data": {
      "cnh": {
        "renach": "texto",
        "numeroRegistro": "texto",
        "numeroFormulario": "texto",
        "dataCadastramento": "2026-01-01",
        "dataPrimeiraHabilitacao": "2026-01-01",
        "ufPrimeiraHabilitacao": "texto",
        "dataUltimaEmissao": "2026-01-01",
        "dataValidade": "2026-01-01",
        "categoriaAtual": "texto",
        "categoriaAutorizada": "texto",
        "categoriaRebaixada": "texto",
        "situacao": "texto",
        "descricaoSituacao": "texto",
        "situacaoAnterior": "texto",
        "descricaoSituacaoAnterior": "texto",
        "ufHabilitacaoAtual": "texto",
        "quadroObservacoes": "texto",
        "quantidadeImpedimentos": 0,
        "numeroListaImpedimento": "texto",
        "numeroPgu": "texto",
        "permissionario": 0,
        "cancelamento": "texto",
        "codigoTransacaoUltimaAtualizacao": 0,
        "dataTransacaoUltimaAtualizacao": "2026-01-01"
      },
      "cpf": "texto",
      "dataNascimento": "2026-01-01",
      "descricaoLocalidadeNascimento": "texto",
      "descricaoNacionalidade": "texto",
      "descricaoSexo": "texto",
      "localidadeNascimento": "texto",
      "nacionalidade": 0,
      "nome": "texto",
      "nomeMae": "texto",
      "nomePai": "texto",
      "numeroFormularioCnh": "texto",
      "numeroRegistro": "texto",
      "ocorrencias": [

      ],
      "restricoesMedicas": "texto",
      "sexo": 0,
      "ufDominio": "texto",
      "ufSolicitanteTransferencia": "texto",
      "motivoRequerimento": [
        "texto"
      ],
      "descricaoMotivoRequerimento": [
        "texto"
      ],
      "motivoRequerimentoPid": [
        "texto"
      ],
      "descricaoMotivoRequerimentoPid": [
        "texto"
      ],
      "cursos": {
        "tpp": {
          "classificacao": "texto",
          "descricao": "texto",
          "data": null,
          "uf": "texto"
        },
        "te": {
          "classificacao": "texto",
          "descricao": "texto",
          "data": null,
          "uf": "texto"
        },
        "tcp": {
          "classificacao": "texto",
          "descricao": "texto",
          "data": null,
          "uf": "texto"
        },
        "tve": {
          "classificacao": "texto",
          "descricao": "texto",
          "data": null,
          "uf": "texto"
        },
        "tci": {
          "classificacao": "texto",
          "descricao": "texto",
          "data": null,
          "uf": "texto"
        },
        "tmf": {
          "classificacao": "texto",
          "descricao": "texto",
          "data": null,
          "uf": "texto"
        },
        "tmt": {
          "classificacao": "texto",
          "descricao": "texto",
          "data": null,
          "uf": "texto"
        },
        "reciclagemInfrator": {
          "modalidade": "texto",
          "descricao": "texto",
          "data": null,
          "uf": "texto"
        },
        "atualizacaoRenovacaoCnh": {
          "modalidade": "texto",
          "descricao": "texto",
          "data": null,
          "uf": "texto"
        }
      },
      "endereco": {
        "logradouro": null,
        "numero": null,
        "complemento": null,
        "bairro": null,
        "municipio": null,
        "descricaoMunicipio": null,
        "uf": "texto",
        "cep": null
      },
      "documento": {
        "numero": "texto",
        "tipo": 0,
        "descricao": "texto",
        "orgaoExpedidor": "texto",
        "ufExpedidor": "texto"
      },
      "habilitacaoEstrangeira": {
        "identificacao": "texto",
        "paisOrigem": "texto",
        "descricaoPaisOrigem": "texto",
        "dataValidade": null,
        "registroNacionalEstrangeiro": "texto"
      },
      "pid": {
        "numeroFormulario": "texto",
        "numeroFormularioCnhBase": "texto",
        "dataValidade": null,
        "ufExpedicao": "texto",
        "situacao": "texto",
        "motivoRequerimento": [
          "texto"
        ],
        "descricaoMotivoRequerimento": [
          "texto"
        ]
      }
    }
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "1.560"
}
```