Introdução

A API Minha CNH é uma API REST que entrega o diagnóstico de uma CNH a partir de um CPF: validade, bloqueios, pontuação, multas, exames médico e toxicológico, e alertas consolidados — os mesmos dados normalizados que alimentam o produto Minha CNH, agora consumíveis programaticamente.

Para quem é

• Frotas e locadoras que precisam verificar a regularidade da CNH de motoristas em volume.
• Despachantes e plataformas de RH/people-ops que integram a consulta de CNH ao seu fluxo.
• Produtos de mobilidade que validam motoristas como parte do onboarding.

Como funciona

O fluxo é assíncrono: você envia um CPF e recebe o reportId na hora; o diagnóstico fica pronto em poucos minutos e é entregue por webhook (ou por polling).

1. Sua aplicação faz POST /api/v1/reports com um CPF e recebe 202 com o reportId.
2. Quando o relatório fica pronto, enviamos um webhook assinado (HMAC-SHA256) para a URL configurada — ou você consulta GET /api/v1/reports/{id}.
3. Cada relatório entregue debita o saldo da organização (modelo pós-pago, com linha de crédito definida pelo time Minha CNH).

Características

• REST + JSON sobre HTTPS.
• Autenticação por Bearer key por organização (uma revelação única na criação).
• Webhooks assinados com HMAC-SHA256 e retentativas com backoff.
• Limites de uso por minuto/dia configuráveis por organização.

Próximos passos

1. Conceitos — termos de CNH e da API.
2. Contratar a API — processo comercial e ativação.
3. Autenticação — gerar a API key e configurar o webhook.
4. Primeira chamada — POST /api/v1/reports na prática.

---

Interessado em acesso? Entre em contato.