Documentos e biometria

Consulta CNH por CPF

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

Falar com o comercial Ver o catálogo

Quando usar

Descrição

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

São apresentados dados relacionados ao status da habilitação (ativa, suspensa ou cassada), data de validade, categoria da CNH, número do documento, data de emissão, órgão expedidor e eventuais restrições.

Essas informações auxiliam na verificação de identidade e na validação da elegibilidade para condução de veículos, sendo úteis em processos de análise cadastral e contratação de serviços.

Requisição

Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.

POST /api/v1/{tenant}/pessoas/consulta-cnh-por-cpf

CampoObrigatórioDescrição
document sim CPF da pessoa, com ou sem máscara. 
{
  "document": "000.000.000-00"
}

Campos de retorno

Campos dentro de data. [] indica lista.

CampoTipo
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.sexo número
data.ufDominio texto
data.ufSolicitanteTransferencia texto
data.motivoRequerimento[] texto
data.descricaoMotivoRequerimento[] texto
data.motivoRequerimentoPid[] texto
data.descricaoMotivoRequerimentoPid[] 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

Exemplo de resposta

Estrutura real da resposta, com valores fictícios.

{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Consulta CNH por CPF",
  "query_slug": "consulta-cnh-por-cpf",
  "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",
      "sexo": 0,
      "ufDominio": "texto",
      "ufSolicitanteTransferencia": "texto",
      "motivoRequerimento": [
        "texto"
      ],
      "descricaoMotivoRequerimento": [
        "texto"
      ],
      "motivoRequerimentoPid": [
        "texto"
      ],
      "descricaoMotivoRequerimentoPid": [
        "texto"
      ],
      "endereco": {
        "logradouro": "texto",
        "numero": "texto",
        "complemento": "texto",
        "bairro": "texto",
        "municipio": "texto",
        "descricaoMunicipio": "texto",
        "uf": "texto",
        "cep": "texto"
      },
      "documento": {
        "numero": "texto",
        "tipo": 0,
        "descricao": "texto",
        "orgaoExpedidor": "texto",
        "ufExpedidor": "texto"
      }
    }
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "1.170"
}

Cobrança e respostas

  • O valor é cobrado por consulta bem-sucedida.
  • 200 — consulta processada (veja status no corpo da resposta)
  • 401 — token ausente, inválido, inativo ou expirado
  • 403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
  • 422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
  • 429 — limite de requisições por minuto da chave excedido
  • 504 — tempo máximo de execução do serviço excedido