RUNT — 驾驶证

端点

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

通过 documentType 与 documentNumber 查询 RUNT 登记的驾驶证信息。响应可包含状态、准驾类别、证明与申请记录、违法提示等。

省略 primerApellido：Premium（含姓名查询）。传入 primerApellido：Basic 价格，见 /v3/co/runt/conductor。

请求头

名称	值
Accept	application/json
Authorization	Bearer <token>

参数

名称	类型	必填	说明
documentType	string	是	CC、CE、PA、PPT 之一。见下表 — PA 是护照，PPT 不是。
documentNumber	string	是	证件号码（无空格和句号）。
primerApellido	string	条件	第一姓氏。PA 必填。CC、CE、PPT 可选。Procuraduría 与 /v2/co/cedula 无法查询护照姓名。

证件类型

RUNT 显示 P. 时不要传 PPT — 那是护照（PA）。PPT 是移民许可。

代码	全称	持有人	RUNT 标识	primerApellido
CC	Cédula de Ciudadanía	哥伦比亚公民（国民身份证）	C.	可选
CE	Cédula de Extranjería	在哥伦比亚的外国居民	E.	可选
PA	Pasaporte（护照）	护照持有人	P.	必填
PPT	Permiso por Protección Temporal	委内瑞拉临时保护许可 — 不是护照	Y.	可选

请求

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

响应

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

说明

• 字段结构以 RUNT 返回为准。
• 本接口校验的证件类型为 CC、CE、PA（护照）、PPT。
• primerApellido 对 PA 必填，对 CC、CE、PPT 可选。