---
title: "DriverCheck - Consulta de CNH"
method: POST
path: "/br/exato/cnh"
tags: ["Exato - Consultas"]
---

# DriverCheck - Consulta de CNH

`POST /br/exato/cnh`

## Query parameters

- `test_mode` boolean
- `lightweight` boolean

## Response `200`

Success

- DriverCheckCnhResponse — DriverCheckCnhResponse
  - `ApiResultType` 'Success' | 'SuccessWithRemarks' | 'InvalidInput' | 'DataUnavailable' | 'NotFound' | 'InvalidParameters' | 'UnsupportedCombination' | 'RemoteUnavailable' | 'Timeout' | 'RetryLimitReached' | 'RemoteError' | 'InProgress' | 'InsufficientCredits' | 'ConcurrentLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'Created' | 'Updated' | 'Deleted' | 'InternalError' | 'ValidationFailed' | 'Conflict' | 'ResourceLocked' | 'PendingApproval' | 'Approved' | 'Rejected' | 'Cancelled' | 'Paused' | 'Resumed' — Novo tipo de resultado unificado para queries e operações administrativas. Substitui TransactionResultType com melhor semântica.
  - `BalanceInBrl` number, double — Saldo atual em BRL.
  - `BalanceInCredits` integer — Saldo atual em créditos.
  - `DataSourceCategory` string — Categoria da fonte de dados
  - `Date` string, date-time — Data da transação.
  - `ElapsedTimeInMilliseconds` integer — Tempo de execução (em milisegundos).
  - `HasPdf` boolean — Indica que existe PDF de comprovante do resultado.
  - `Message` string — Mensagem.
  - `OriginalFilesUrl` string — Url para download dos arquivos originais da transação (quando disponíveis).
  - `OutdatedResult` boolean — Indica que o resultado é datado.
  - `PdfUrl` string — Url para download do arquivo de comprovante em PDF da transação (quando disponível).
  - `ResultSubtype` string — Subtipo específico do resultado para fornecer contexto adicional (ex: 'duplicate_name', 'invalid_cpf').
  - `ResultTypeCode` integer — Código numérico do resultado (compatível com TransactionResultTypeCode mas extensível).
  - `TotalCost` number, double — Internal use only.
  - `TotalCostInCredits` integer — Custo total da transação em créditos.
  - `TransactionResultType` 'Success' | 'SuccessWithRemarks' | 'InvalidInputData' | 'UnavailableData' | 'EntityNotFound' | 'InvalidParameters' | 'ParametersNotSupported' | 'RemoteSystemUnavailable' | 'Timeout' | 'AttemptsLimitReached' | 'RemoteSystemError' | 'AsyncExecutionInProgress' | 'AwaitingExecution' | 'BirthDateRequired' | 'InsufficientBalance' | 'SimultaneousTransactionsLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'InternalError' — <table class="transaction"><thead><tr><th>TransactionResultType Code</th><th>TransactionResultType</th><th>Definitivo</th><th>Faturavel</th><th>Erro</th></tr></thead><tbody><tr><td>1</td><td>Sucesso</td><td>Verdadeiro</td><td>Verdadeiro</td><td>Falso</td></tr><tr><td>2</td><td>Sucesso parcial ou com observações</td><td>Verdadeiro</td><td>Verdadeiro</td><td>Falso</td></tr><tr><td>3</td><td>Entrada ou documento inválido</td><td>Verdadeiro</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>4</td><td>Dados não disponíveis</td><td>Verdadeiro (no dia)</td><td>Falso</td><td>Falso</td></tr><tr><td>5</td><td>Entidade ou documento inexistente/não encontrado</td><td>Verdadeiro</td><td>Verdadeiro</td><td>Falso</td></tr><tr><td>6</td><td>Parâmetros de entrada inválidos</td><td>Verdadeiro</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>7</td><td>Combinação de parâmetros não suportados</td><td>Verdadeiro</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>8</td><td>Fonte de dados ou sistema remoto indisponível</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>9</td><td>Limite de tempo esgotado</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>10</td><td>Limite de tentativas atingido</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>11</td><td>Erro na fonte de dados ou sistema remoto</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>12</td><td>Transação em execução</td><td>Falso</td><td>Falso</td><td>Falso</td></tr><tr><td>101</td><td>Saldo em créditos insuficiente, entre em contato</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>102</td><td>Limite de transações simultâneas atingido, entre em contato</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>103</td><td>Transação não disponível, entre em contato</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>104</td><td>Credenciais inválidas ou acesso negado, entre em contato</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>105</td><td>Transação cancelada, entre em contato</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>255*</td><td>Erro interno não esperado, entre em contato</td><td>Verdadeiro (no dia)</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>* Consulta em manutenção, tente refazer mais tarde ou entre em contato com a Direct Digital para notificação do problema</td></tr></tbody></table>
  - `TransactionResultTypeCode` integer — Código do tipo de resultado da transação.
  - `UniqueIdentifier` string — Identificador único da transação. Recomendado armazenar para controle e depuração.
  - `Result` DriverCheckCnhResult — DriverCheckCnhResult
    - `Name` string — Nome do motorista
    - `MotherName` string — Nome da mãe
    - `FatherName` string — Nome do pai
    - `LegalName` string — Nome legal
    - `DocumentNumber` string — Número do documento (CPF)
    - `CnhPhotoUrl` string — Url da foto
    - `Address` string — Endereço
    - `RgNumber` string — Número do RG
    - `RgState` string — UF do RG
    - `RgIssuer` string — Emissor do RG
    - `BirthDate` string — Data de nascimento
    - `Email` string — E-mail
    - `Phone` string — Telefone
    - `DriversLicenceNumber` string — Número da CNH
    - `Category` string — Categoria da CNH
    - `ExpirationDate` string — Data de validade
    - `IssueDate` string — Data de emissão
    - `FirstCnh` string — Data da primeira CNH
    - `Renach` string — Número do Renach
    - `RegistryNumber` string — Número de registro
    - `Toxicological` ToxicologicalInfo — ToxicologicalInfo
      - `CollectionalDate` string — Data da coleta
      - `DateOfUse` string — Data de uso
      - `Situation` string — Situação
      - `DueDate` string — Data de vencimento
    - `DetailScoreHistory` CnhScoreItem[] — Histórico de pontuação detalhada
      - `Description` string — Descrição
      - `Date` string — Data da infração
      - `Punctuation` string — Pontuação
    - `DetailScore12Months` CnhScoreItem[] — Pontuação detalhada nos últimos 12 meses
      - `Description` string — Descrição
      - `Date` string — Data da infração
      - `Punctuation` string — Pontuação
    - `TotalScore12Months` unknown
    - `Blocks` CnhBlocked[] — Informações de bloqueio de CNH
      - `Uf` string — UF
      - `Date` string — Data
      - `Description` string — Descrição
      - `PenaltyDays` string — Dias de Penalidade
      - `PenaltyStartDate` string — Data Início da Penalidade
      - `PenaltyEndDate` string — Data Fim da Penalidade
    - `Exams` CnhExam[] — Exames realizados
      - `Name` string — Nome do exame
      - `Date` string — Data do exame
      - `Result` string — Resultado do exame
      - `Validity` string — Validade do exame
      - `DesiredCategory` string — Categoria desejada
      - `AllowedCategory` string — Categoria permitida
      - `CityHeld` string — Cidade de realização
      - `Uf` string — UF
    - `Courses` CnhCourse[] — Cursos realizados
      - `Name` string — Nome do curso
      - `StartDate` string — Data de início
      - `EndDate` string — Data de término
      - `Workload` string — Carga horária
      - `Category` string — Categoria
      - `Modality` string — Modalidade
      - `DueDate` string — Data de vencimento
      - `CityHeld` string — Cidade de realização
      - `Uf` string — UF
    - `Observation` string — Observações

---

[API](https://skmtc.dev/directdigital/apis/backend-apis.md) · [All operations](https://skmtc.dev/directdigital/apis/backend-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/directdigital/backend-apis/revisions/a3305895eccd/schema)