Skip to main content

Validación de Licencia de Conducir en RUNT (Básico)

La misma consulta de conductor que Premium v2 (GET /v2/co/runt/conductor), cobrada al precio Básico de conductor. Debe enviar primerApellido (mínimo 2 caracteres) para todos los tipos de documento, incluido TI. Si lo omite, la API responde 409 MissingParameter. Este endpoint no busca el apellido y no suma el precio de RUI.

Use esta ruta cuando ya conoce el primer apellido. Enviar primerApellido en v2 se cobra a este mismo precio Básico.

v2 y v3​

Premium GET /v2/co/runt/conductorBásico GET /v3/co/runt/conductor
Apellido (primerApellido)No es obligatorio, salvo PA, que sí lo exige. Verifik encuentra el apellido cuando usted lo omite.Obligatorio para todos los tipos de documento (mínimo 2 caracteres).
Tipos de documentoCC, TI, CE, PA, PPTCC, TI, CE, PA, PPT
CobroSin apellido: Premium. Para TI sin apellido, el precio de lista del conductor más el precio de lista de RUI (GET /v2/co/rui). Con apellido: Básico, el mismo precio que v3.Precio Básico de conductor. No hay búsqueda de apellido ni precio de RUI.

Service URL​

GET https://api.verifik.co/v3/co/runt/conductor

Headers​

NameValue
Acceptapplication/json
AuthorizationBearer <token>

Parámetros​

NameTypeRequiredDescription
documentTypestringYesUno de CC, TI, CE, PA, PPT. PA es pasaporte, PPT no lo es. TI es tarjeta de identidad.
documentNumberstringYesNúmero de documento del conductor, sin espacios ni puntos.
primerApellidostringYesPrimer apellido (mínimo 2 caracteres). Obligatorio para todos los tipos de documento, incluido TI.

Tipos de documento​

CódigoNombre completoQuién lo tieneEtiqueta RUNTprimerApellido
CCCédula de CiudadaníaCiudadanos colombianosC.Obligatorio
TITarjeta de IdentidadTarjeta de identidad colombiana—Obligatorio
CECédula de ExtranjeríaExtranjeros residentesE.Obligatorio
PAPasaporteTitulares de pasaporteP.Obligatorio
PPTPermiso por Protección TemporalPermiso temporal venezolano — no es pasaporteY.Obligatorio

Solicitud​

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v3/co/runt/conductor", {
params: {
documentType: "CC",
documentNumber: "123456789",
primerApellido: "GARCIA",
},
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);

Respuesta​

{
"data": {
"documentType": "TI",
"documentNumber": "1002003001",
"fullName": "ANA MARIA EJEMPLO FICTICIO",
"driverStatus": "ACTIVO",
"citizenStatus": "ACTIVA",
"licenses": [
{
"category": "A2",
"status": "ACTIVA",
"dueDate": "01/06/2034",
"expeditionDate": "01/06/2024"
}
]
},
"signature": {
"dateTime": "January 15, 2026 12:00 PM",
"message": "Certified by Verifik.co"
}
}

Los valores son ficticios. Una respuesta real de TI usa los mismos campos que Premium v2.

Notas​

  • Una solicitud al precio Básico de conductor, también para TI cuando envía primerApellido.
  • Sin primerApellido este endpoint no busca el apellido y no suma el precio de RUI.
  • Los valores aceptados de documentType son CC, TI, CE, PA y PPT.
  • Para la resolución automática del apellido, use /v2/co/runt/conductor. En ese endpoint, TI sin primerApellido se cobra como el precio de lista del conductor más el precio de lista de RUI.