Documentação

Primeira Chamada

Quick-start com exemplos curl e Node.js. Crie um relatório de CNH e receba o diagnóstico.

Pré-requisitos

  • Organização com API habilitada pelo time Minha CNH.
  • API key gerada em Configurações → API.
  • (Opcional) Webhook configurado para receber o resultado.

Criar um relatório

curl -X POST "https://minhacnh.doutormultas.com.br/api/v1/reports" \
  -H "Authorization: Bearer cnh_live_<prefix>_<secret>" \
  -H "Content-Type: application/json" \
  -d '{
    "cpf": "123.456.789-09",
    "externalRef": "driver-42"
  }'

Resposta 202 Accepted:

{
  "reportId": "clxyz...",
  "status": "PROCESSING",
  "driver": {
    "id": "cldrv...",
    "cpf": "123.456.789-09"
  },
  "statusUrl": "/api/v1/reports/clxyz...",
  "webhookConfigured": true,
  "estimatedDeliveryAt": "2026-06-01T12:05:00Z"
}

Resposta em ~5 minutos

O relatório é processado de forma assíncrona. O 202 confirma o enfileiramento. O resultado chega via webhook ou via polling no statusUrl.

Receber o resultado (polling)

curl "https://minhacnh.doutormultas.com.br/api/v1/reports/clxyz..." \
  -H "Authorization: Bearer cnh_live_<prefix>_<secret>"

Quando status === "DELIVERED" o campo diagnosis contém o diagnóstico completo. Ver Shape do Payload para a lista completa de campos.

Próximos passos