Driver's License Validation in RUNT (Basic)

Same RUNT driver lookup as Premium v2, billed at the current conductor price. You must send primerApellido. Omitting it returns 409 MissingParameter.

Use this path when you already know the first last name. If you stay on v2 and send primerApellido, you also pay this Basic rate without changing the URL.

Endpoint

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

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

Name	Type	Required	Description
documentType	string	Yes	One of CC, CE, PA, PPT. PA is passport, PPT is not.
documentNumber	string	Yes	Driver's document number, without spaces or periods.
primerApellido	string	Yes	First last name (min 2 characters). Required for every document type.

Document types

Code	Full name	Who holds it	RUNT label	primerApellido
CC	Cédula de Ciudadanía	Colombian citizens (national ID)	C.	Required
CE	Cédula de Extranjería	Foreign residents in Colombia	E.	Required
PA	Pasaporte (passport)	Passport holders	P.	Required
PPT	Permiso por Protección Temporal	Venezuelan temporary-protection permit — not a passport	Y.	Required

Request

Node.js

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

Python

import os, requests

url = "https://api.verifik.co/v3/co/runt/conductor"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789", "primerApellido": "GARCIA"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Response

200

{
	"data": {
		"documentType": "CC",
		"documentNumber": "63535709",
		"fullName": "ARLETH PATRICIA RUEDA CORREA",
		"driverStatus": "ACTIVO",
		"citizenStatus": "ACTIVA",
		"licenses": [
			{
				"category": "B1",
				"status": "ACTIVA",
				"dueDate": "19/09/2034",
				"expeditionDate": "19/09/2024"
			}
		]
	},
	"signature": {
		"dateTime": "October 10, 2025 7:29 PM",
		"message": "Certified by Verifik.co"
	}
}

409

{
	"code": "MissingParameter",
	"message": "\"primerApellido\" is required"
}

Notes

• One API request and one credit row at the Basic conductor price.
• Without primerApellido this endpoint does not fall back to a name lookup.
• For automatic last-name resolution (Premium), use /v2/co/runt/conductor.