🇨🇴Licencia de Conducción

Servicio para consultar licencias de conducción utilizando el documento de identificación.

Verificación de Licencia de Conducción Colombiana

GET - https://api.verifik.co/v2/co/runt/conductor

El servicio de Información de Licencias de Conducción proporciona detalles completos sobre los titulares de licencias de conducción en Colombia. Al utilizar este servicio, puedes acceder a información como el tipo y número de documento, nombre completo, fecha de vencimiento, estado y categoría de la licencia. También te permite verificar si la licencia está activa, suspendida o cancelada, e incluye detalles sobre impuestos de tránsito y otra información relacionada.

Este servicio es especialmente útil para organizaciones que necesitan validar la información de las licencias de conducción con fines como seguros, empleo y cumplimiento normativo.

Implementación

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query Parameters

Name	Type	Required?	Description	Example
documentType	String	True	Document Type: Allowed values are: CC, CE, PA, RC.	CC
documentNumber	String	True	Driver's document number, without spaces or periods.	123456789

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/co/runt/conductor>',
  params: {documentType: 'CC', documentNumber: '123456789'},
    headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_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/co/runt/conductor?documentType=CC&documentNumber=", 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/co/runt/conductor?documentType=CC&documentNumber=")!,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/co/runt/conductor?documentType=CC&documentNumber=');
$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();
}

Response

200

{
  "data": {
    "citizenStatus": "ACTIVA",
    "consultationDateTime": "2024-04-16T19:15:42.893Z",
    "documentNumber": "1234345456",
    "documentType": "CC",
    "driverStatus": "ACTIVO",
    "fullName": "MATEO VERIFIK",
    "inscriptionDate": "18/12/2009",
    "inscriptionNumber": "5597541",
    "licenses": [
      {
        "category": "B1",
        "dueDate": "04/11/2033",
        "expeditionDate": "04/11/2023",
        "licenceNumber": "1234345456",
        "status": "ACTIVA",
        "substratum": "LC03006724131"
      },
      {
        "category": "A2",
        "dueDate": "20/09/2024",
        "expeditionDate": "20/09/2014",
        "licenceNumber": "1234345456",
        "status": "ACTIVA",
        "substratum": "LC03006724131"
      }
    ],
    "totalLicenses": "2",
    "transitTaxes": {
      "paceAndSafe": "NO"
    },
    "firstName": "MATEO",
    "lastName": "VERIFIK ",
    "arrayName": [
      "MATEO",
      "VERIFIK",
    ]
  },
  "signature": {
    "dateTime": "September 16, 2024 4:50 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "UIQ26"
}

404

{
"code": "NotFound",
"message": "Record not found.",
"signature": {
"dateTime": "August 31, 2022 3:24 PM",
"message": "Certified by Verifik.co"
}
}

409

{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}

409

{
"code": "MissingParameter",
"message": "documentType must be one of: [CC]"
}