SENATRAN · 19 campos

API para leitura e validação de CNH

Extraia automaticamente os dados do QR Code VIO da CNH digital ou impressa: nome, CPF, categoria, validade, número de registro e mais. Receba tudo em JSON, pronto para o seu cadastro.

R$0,25 por documento · R$0,50 de crédito ao criar a conta

SENATRAN · documento ilustrativo

CNH

Nome
MARIA EXEMPLO DA SILVA
CPF
***.456.789-**
Data de Nascimento
12/03/1990
Cat. Hab.
AB
VIO API
GET /api/qrcode/result/{id}
{
  "status": "completed",
  "qr_type": "vio",
  "cost": 0.25,
  "vio_result": {
    "Nome": "MARIA EXEMPLO DA SILVA",
    "CPF": "***.456.789-**",
    "Data de Nascimento": "12/03/1990",
    "Cat. Hab.": "AB",
    "Nº Registro": "01234567890",
    "Validade": "15/03/2036",
    "1ª Habilitação": "20/05/2009",
    "UF": "PR",
    "Data de Emissão": "15/03/2026"
  }
}
  • Documento reconhecido
  • QR Code VIO identificado
  • 19 campos disponíveis

Campos devolvidos para CNH

19 campos no total, com os rótulos do próprio documento. Alguns deles:

  • Nome
  • Nome Civil
  • Doc. Identidade/Órg. Emissor/UF
  • CPF
  • Data de Nascimento
  • Filiação Pai
  • Filiação Mãe
  • Permissão

e mais 11 campos. A lista completa aparece no resultado de cada leitura.

Duas chamadas e pronto

Envie a foto ou o PDF da CNH em base64. A API detecta o documento, lê o QR Code VIO e devolve os campos. Você não precisa dizer qual documento é.

curl -X POST https://vio.api.br/api/qrcode/read \
  -H "X-API-Key: sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{"image": "data:image/jpeg;base64,..."}'

curl https://vio.api.br/api/qrcode/result/ID \
  -H "X-API-Key: sua_api_key"
resposta
{
  "status": "completed",
  "qr_type": "vio",
  "cost": 0.25,
  "vio_result": {
    "Nome": "MARIA EXEMPLO DA SILVA",
    "CPF": "***.456.789-**",
    "Data de Nascimento": "12/03/1990",
    "Cat. Hab.": "AB",
    "Nº Registro": "01234567890",
    "Validade": "15/03/2036",
    "1ª Habilitação": "20/05/2009",
    "UF": "PR",
    "Data de Emissão": "15/03/2026"
  }
}

Onde a leitura de CNH entra

Transportadoras

Cadastro de motoristas sem digitação e com validade da CNH conferida.

Locadoras

Onboarding do condutor pela foto da CNH no balcão ou no app.

Gestão de frotas

Conferência periódica da categoria e validade dos condutores.

Seguradoras

Confirmação dos dados do condutor em propostas e sinistros.

Teste com um documento real

R$0,25 por documento, sem mensalidade. A conta vem com R$0,50 de crédito.

Fale conosco