Skip to main content

Driver's License Validation in RUNT (Basic)

Same driver lookup as Premium v2 (GET /v2/co/runt/conductor), billed at the Basic conductor price. You must send primerApellido (minimum 2 characters) for every document type, including TI. Omitting it returns 409 MissingParameter. This endpoint does not look up the surname and does not add the RUI price.

Use this path when you already know the first last name. Sending primerApellido on v2 is billed at this same Basic price.

v2 and v3​

Premium GET /v2/co/runt/conductorBasic GET /v3/co/runt/conductor
Surname (primerApellido)Not required, except PA, which requires it. Verifik finds the surname when you omit it.Required for every document type (minimum 2 characters).
Document typesCC, TI, CE, PA, PPTCC, TI, CE, PA, PPT
BillingOmit the surname: Premium. For TI with no surname, the driver list price plus the RUI list price (GET /v2/co/rui). Send the surname: Basic, the same price as v3.Basic conductor price. No surname lookup and no RUI price.

Endpoint​

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

Headers​

NameValue
Acceptapplication/json
AuthorizationBearer <token>

Parameters​

NameTypeRequiredDescription
documentTypestringYesOne of CC, TI, CE, PA, PPT. PA is passport, PPT is not. TI is tarjeta de identidad.
documentNumberstringYesDriver's document number, without spaces or periods.
primerApellidostringYesFirst last name (minimum 2 characters). Required for every document type, including TI.

Document types​

CodeFull nameWho holds itRUNT labelprimerApellido
CCCédula de CiudadaníaColombian citizens (national ID)C.Required
TITarjeta de IdentidadColombian tarjeta de identidad—Required
CECédula de ExtranjeríaForeign residents in ColombiaE.Required
PAPasaporte (passport)Passport holdersP.Required
PPTPermiso por Protección TemporalVenezuelan temporary-protection permit — not a passportY.Required

Request​

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);

Response​

{
"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"
}
}

The values above are fake. A live TI response uses the same fields as Premium v2.

Notes​

  • One API request at the Basic conductor price, including TI when you send primerApellido.
  • Without primerApellido this endpoint does not look up the surname and does not add the RUI price.
  • Accepted documentType values are CC, TI, CE, PA, and PPT.
  • For automatic surname resolution, use /v2/co/runt/conductor. On that endpoint, TI without primerApellido is billed as the driver list price plus the RUI list price.