Documentos e biometria

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.

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.

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-estendida

Campo	Obrigatório	Descriçã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.

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

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 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"
}

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