A Consulta de CNH permite obter informações sobre a habilitação de um condutor a partir do seu CPF, incluindo número da CNH, UF de emissão, data da primeira habilitação e nacionalidade. A consulta também retorna o nome do titular e indica se o condutor está em período de permissão, proporcionando uma visão objetiva e confiável sobre a licença e seu portador.
Artigo do Blog
CNH - Carteira Nacional de Habilitação
Casos de Uso
- Consulta cadastral de informações relacionadas à Carteira Nacional de Habilitação de um condutor.
- Validação de dados de habilitação a partir do CPF.
- Identificação do número da CNH, UF de emissão e data da primeira habilitação.
- Apoio a processos de compliance, ESG, cadastro, análise de risco e validação documental.
- Verificação se o condutor está em período de permissão.
- Confirmação de dados básicos do titular, como nome e nacionalidade.
Aplicações
- Compliance/ESG
Benefícios
- Acesso automatizado a informações cadastrais da CNH.
- Consulta objetiva e confiável a partir do CPF do condutor.
- Reduz erros manuais em processos de validação documental.
- Facilita integrações com sistemas internos de cadastro, compliance e análise de risco.
- Retorna dados estruturados em formato JSON.
- Permite identificar se o condutor é permissionário.
O endpoint /api/CarteiraNacionalHabilitacao permite consultar informações da Carteira Nacional de Habilitação de um condutor a partir do seu CPF, retornando dados como número da CNH, UF de emissão, data da primeira habilitação, nacionalidade, nome do titular e indicação de permissionário.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/ConsultaCNHEndpoint
GET https://apiv3.directd.com.br/api/ConsultaCNH?CPF={0}&Token=Seu_TokenDescrição: Endpoint para realizar consultas CNH - Carteira Nacional de Habilitação.
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- CNH: Informa o número da CNH do indivíduo.
- CPF: CPF do indivíduo
- Data da Primeira CNH: Informa a data da primeira CNH do indivíduo.
- Flag Permissionário: Informa se o indivíduo possui permissionário. True(verdadeiro) ou false(falso).
- Nacionalidade: Informa a nacionalidade do indivíduo.
- Nome: Nome do indivíduo/registro
- UF: Unidade Federativa (estado) referente ao registro
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CPF | string | Sim | O parâmetro CPF pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"cpf": "string",
"nome": "string",
"cnh": "string",
"uf": "string",
"dataPrimeiraCNH": "string",
"nacionalidade": "string",
"permissionario": true
}
}Erros Comuns
| Código | Descrição |
|---|---|
400 | Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos. |
401 | Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso. |
403 | Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
404 | Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado. |
408 | Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido. |
500 | Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
503 | Consulta em Manutenção: a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |
Notas Importantes
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228