RUNT — Carteira de motorista

Endpoint

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

Consulta a carteira de habilitação no RUNT com documentType e documentNumber. A resposta pode incluir situação da licença, categorias, certificados, solicitações e indicação de multas.

Sem primerApellido: tarifa Premium (resolução do nome). Com primerApellido: tarifa Basic, como /v3/co/runt/conductor.

Cabeçalhos

Nome	Valor
Accept	application/json
Authorization	Bearer <token>

Parâmetros

Nome	Tipo	Obrigatório	Descrição
documentType	string	Sim	Um de CC, CE, PA, PPT. Veja a tabela — PA é passaporte, PPT não é.
documentNumber	string	Sim	Número do documento sem espaços nem pontos.
primerApellido	string	Condicional	Primeiro sobrenome. Obrigatório para PA. Opcional para CC, CE e PPT. Procuraduría e /v2/co/cedula não consultam passaportes.

Tipos de documento

Não envie PPT quando o RUNT mostrar P. — isso é passaporte (PA). PPT é um visto/permissão migratória.

Código	Nome completo	Quem possui	Rótulo RUNT	primerApellido
CC	Cédula de Ciudadanía	Cidadãos colombianos (RG nacional)	C.	Opcional
CE	Cédula de Extranjería	Estrangeiros residentes na Colômbia	E.	Opcional
PA	Pasaporte (passaporte)	Portadores de passaporte	P.	Obrigatório
PPT	Permiso por Protección Temporal	Permissão temporária venezuelana — não é passaporte	Y.	Opcional

Requisição

Node.js

import axios from "axios";

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

Python

import os, requests

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

Resposta

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"
			}
		],
		"infractions": {
			"tieneMultas": "NO"
		}
	},
	"signature": {
		"dateTime": "October 10, 2025 7:29 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "3R2V0"
}

404

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

409

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

Observações

• A estrutura segue o retorno do RUNT.
• Tipos de documento validados neste endpoint: CC, CE, PA (passaporte), PPT.
• primerApellido é obrigatório para PA e opcional para CC, CE, PPT.