Consulta a CNH completa do condutor (premium)

curl --request POST \
  --url https://api.jusfy.com.br/api/v1/consultas/cnh-premium \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "document": "12345678909"
}
'

import requests

url = "https://api.jusfy.com.br/api/v1/consultas/cnh-premium"

payload = { "document": "12345678909" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({document: '12345678909'})
};

fetch('https://api.jusfy.com.br/api/v1/consultas/cnh-premium', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jusfy.com.br/api/v1/consultas/cnh-premium",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'document' => '12345678909'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "statusCode": 200,
  "message": "Consulta concluída com sucesso",
  "timestamp": "2026-07-28T18:00:00.000Z",
  "path": "/api/v1/consultas/cnh-premium",
  "result": {
    "driver": {
      "cpf": "12345678909",
      "name": "MARIA EXEMPLO DA SILVA",
      "birthDate": "1990-01-01",
      "gender": "F",
      "motherName": "ANA EXEMPLO DA SILVA",
      "fatherName": "JOSE EXEMPLO DA SILVA",
      "birthplace": null,
      "email": "maria.exemplo@example.com",
      "phone": null,
      "city": "SAO PAULO",
      "state": "SP"
    },
    "license": {
      "registrationNumber": "00000000001",
      "number": "0000000002",
      "renach": "SP000000001",
      "category": "B",
      "issueDate": "2024-01-01",
      "expirationDate": "2034-01-01",
      "firstLicenseDate": "2010-01-01",
      "remarks": null,
      "pgu": null
    },
    "identityDocument": {
      "type": null,
      "number": null,
      "issuer": "SP"
    },
    "address": {
      "zipCode": "01000000",
      "street": "RUA DE EXEMPLO 100",
      "complement": null,
      "neighborhood": "CENTRO",
      "city": "SAO PAULO",
      "state": "SP"
    },
    "points": null,
    "blocks": [],
    "exams": [
      {
        "name": "EXAME DE EXEMPLO",
        "examDate": "2024-01-01",
        "expirationDate": null,
        "assignedCategory": "B",
        "licensedCategory": "B",
        "result": "APTO",
        "city": "SAO PAULO",
        "state": "SP"
      }
    ],
    "courses": [],
    "toxicologyExams": null
  }
}

POST

api

consultas

cnh-premium

Consulta a CNH completa do condutor (premium)

curl --request POST \
  --url https://api.jusfy.com.br/api/v1/consultas/cnh-premium \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "document": "12345678909"
}
'

import requests

url = "https://api.jusfy.com.br/api/v1/consultas/cnh-premium"

payload = { "document": "12345678909" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({document: '12345678909'})
};

fetch('https://api.jusfy.com.br/api/v1/consultas/cnh-premium', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jusfy.com.br/api/v1/consultas/cnh-premium",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'document' => '12345678909'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "statusCode": 200,
  "message": "Consulta concluída com sucesso",
  "timestamp": "2026-07-28T18:00:00.000Z",
  "path": "/api/v1/consultas/cnh-premium",
  "result": {
    "driver": {
      "cpf": "12345678909",
      "name": "MARIA EXEMPLO DA SILVA",
      "birthDate": "1990-01-01",
      "gender": "F",
      "motherName": "ANA EXEMPLO DA SILVA",
      "fatherName": "JOSE EXEMPLO DA SILVA",
      "birthplace": null,
      "email": "maria.exemplo@example.com",
      "phone": null,
      "city": "SAO PAULO",
      "state": "SP"
    },
    "license": {
      "registrationNumber": "00000000001",
      "number": "0000000002",
      "renach": "SP000000001",
      "category": "B",
      "issueDate": "2024-01-01",
      "expirationDate": "2034-01-01",
      "firstLicenseDate": "2010-01-01",
      "remarks": null,
      "pgu": null
    },
    "identityDocument": {
      "type": null,
      "number": null,
      "issuer": "SP"
    },
    "address": {
      "zipCode": "01000000",
      "street": "RUA DE EXEMPLO 100",
      "complement": null,
      "neighborhood": "CENTRO",
      "city": "SAO PAULO",
      "state": "SP"
    },
    "points": null,
    "blocks": [],
    "exams": [
      {
        "name": "EXAME DE EXEMPLO",
        "examDate": "2024-01-01",
        "expirationDate": null,
        "assignedCategory": "B",
        "licensedCategory": "B",
        "result": "APTO",
        "city": "SAO PAULO",
        "state": "SP"
      }
    ],
    "courses": [],
    "toxicologyExams": null
  }
}

Autorizações

x-api-key

string

header

obrigatório

Corpo

application/json

document

string

obrigatório

CPF do condutor, com ou sem máscara. Separadores são aceitos e ignorados. O dígito verificador é validado antes da consulta.

Exemplo:

"12345678909"

Resposta

CNH localizada para o CPF informado. Texto não informado vem null; datas vêm em YYYY-MM-DD. Nas listas (blocks, exams, courses, toxicologyExams), [] significa que não há registros e null que a informação não está disponível. points null é pontuação não informada, não zero. Campos novos podem ser acrescentados sem mudança de versão.

The response is of type object.

Comece aqui

Fundamentos

Produtos

Referência

Consulta a CNH completa do condutor (premium)

Autorizações

Corpo

Resposta