🇺🇸 Kansas (EUA) — Carteira de motorista

Este serviço permite validar programaticamente o status, restrições, endossos e designações de carteiras de motorista emitidas no estado do Kansas (EUA). Com um número válido da licença e os demais parâmetros obrigatórios, a resposta pode incluir status da licença, data de validade, tipo de credencial e demais detalhes retornados pela fonte.

É útil para conferir credenciais de motoristas e apoiar fluxos de conformidade e onboarding.

Endpoint

GET https://api.verifik.co/v2/usa/kansas/driver-license

Consulta por documentNumber, dateOfBirth (formato DD/MM/AAAA), firstName e lastName. A data de nascimento deve seguir o formato exigido pela API para evitar erro de validação.

Cabeçalhos

Nome	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parâmetros

Nome	Tipo	Obrigatório	Descrição	Exemplo
documentNumber	string	Sim	Número da carteira de motorista do Kansas.	K12345678
dateOfBirth	string	Sim	Data de nascimento do titular (DD/MM/AAAA).	29/01/1974
firstName	string	Sim	Nome do titular.	MATEO
lastName	string	Sim	Sobrenome do titular.	VERIFIK

Requisição

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/usa/kansas/driver-license',
  params: {
    documentNumber: 'K12345678',
    dateOfBirth: '29/01/1974',
    firstName: 'MATEO',
    lastName: 'VERIFIK'
  },
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer <seu_token>'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/usa/kansas/driver-license?documentNumber=K12345678&dateOfBirth=29/01/1974&firstName=MATEO&lastName=VERIFIK", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/usa/kansas/driver-license?documentNumber=K12345678&dateOfBirth=29/01/1974&firstName=MATEO&lastName=VERIFIK")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/usa/kansas/driver-license?documentNumber=K12345678&dateOfBirth=29/01/1974&firstName=MATEO&lastName=VERIFIK');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
?>

Resposta

200

{
  "data": {
    "cdlStatus": "",
    "currentCredentialInformation": [
      {
        "credentialType": "Driver's License",
        "issueDate": "03/04/2020",
        "expirationDate": "01/29/2026"
      }
    ],
    "dateOfBirth": "29/1/1974",
    "dlNumber": "K02884565",
    "dlStatus": "Valid",
    "documentNumber": "K12345678",
    "firstName": "MATEO",
    "lastName": "VERIFIK",
    "systemGeneratedDl": "N"
  },
  "signature": {
    "dateTime": "January 19, 2024 4:36 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "1Q8UH"
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

409

{
  "code": "MissingParameter",
  "message": "missing documentNumber\n. missing dateOfBirth\n. missing firstName\n. missing lastName\n"
}

409 (formato)

{
  "code": "MissingParameter",
  "message": "dateOfBirth format required: DD/MM/YYYY\n"
}