RUNT - 仅凭车牌查询车辆记录

仅凭车牌查询 RUNT 官方车辆信息。与按车牌车辆（完整）不同，此接口不需要车主的 documentType 或 documentNumber。

在没有车主证件、但仍需哥伦比亚车牌的身份、技术与状态区块时使用。

API 返回内容

• informacionGeneral — 车牌、品牌、系列、型号、类别、服务、状态及登记字段（如有）
• datosTecnicos — 技术字段（如有）
• 时效区块，如 soat[] 与 tecnoMecanica[]（如有）
• 其他 RUNT 车辆区块（solicitudes、polizasResponsabilidadCivil 等，如响应包含）
• documentType 与 documentNumber 可能为 null
• 经 Verifik 签名的响应

API 参考

端点

GET https://api.verifik.co/v2/co/runt/vehicle-by-plate-only

将 plate 作为查询参数发送。处理程序返回完整的 RUNT 车辆结构。身份、技术与状态区块在可用时包含。车主证件字段不是必填项，可能返回 null。

请求头

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

参数

名称	类型	必填	说明	示例
plate	string	是	哥伦比亚车牌，5–9 位字母数字。	AA123BA

请求

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehicle-by-plate-only", {
	params: { plate: "AA123BA" },
	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/vehicle-by-plate-only"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
response = requests.get(url, headers=headers, params={"plate": "AA123BA"})
print(response.json())

响应

200

{
	"data": {
		"datosTecnicos": {
			"noEjes": "2",
			"pasajerosSentados": "5",
			"pesoBrutoVehicular": "1650"
		},
		"documentNumber": null,
		"documentType": null,
		"garantiasFavorDe": [],
		"garantiasMobiliarias": [],
		"informacionBlindaje": {},
		"informacionGeneral": {
			"cilidraje": "1600",
			"claseVehiculo": "AUTOMOVIL",
			"clasificacion": "AUTOMOVIL",
			"color": "BLANCO PERLA",
			"estadoDelVehiculo": "ACTIVO",
			"fechaMatricula": "15/03/2018",
			"linea": "COROLLA",
			"marca": "TOYOTA",
			"modelo": "2020",
			"noChasis": "9FB10000001",
			"noLicenciaTransito": "110000001",
			"noMotor": "MTR0000001",
			"noPlaca": "AA123BA",
			"noVin": "9FB10000001",
			"organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
			"prendas": "NO",
			"puertas": "4",
			"repotenciado": "NO",
			"tarjetaRegistro": null,
			"tarjetaServicio": "NO",
			"tieneGravamenes": "NO",
			"tipoCarroceria": "SEDAN",
			"tipoCombustible": "GASOLINA",
			"tipoServicio": "Particular"
		},
		"limitacionPropiedad": [],
		"normalizacionSaneamiento": [],
		"plate": "AA123BA",
		"polizasResponsabilidadCivil": [],
		"soat": [
			{
				"entidadExpideSoat": "SEGUROS DEL ESTADO S.A.",
				"estado": "VIGENTE",
				"fechaExpedicion": "01/01/2024",
				"fechaVencimiento": "31/12/2024",
				"fechaVigencia": "02/01/2024",
				"noPoliza": "SOAT-000001",
				"tipoTarifa": "221"
			}
		],
		"solicitudes": [
			{
				"entidad": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
				"estado": "AUTORIZADA",
				"fechaSolicitud": "15/03/2018",
				"noSolicitud": "110000001",
				"tramitesRealizados": "Tramite matricula inicial"
			}
		],
		"tarjetaOperacion": {},
		"tecnoMecanica": [
			{
				"vigente": "SI"
			}
		],
		"vin": "9FB10000001"
	},
	"signature": {
		"dateTime": "September 16, 2026 8:00 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "ABCDE"
}

404

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

409

{
	"code": "MissingParameter",
	"message": "missing plate"
}

409（不可用）

{
	"code": "Endpoint_out_of_service",
	"message": "Endpoint_out_of_service"
}

说明

• AppFeature 代码为 colombia_api_runt_vehicle_by_plate_only。
• 此路由是 GET /v2/co/runt/vehicle-by-plate 的仅车牌版本。不接受车主的 documentType 或 documentNumber。
• 载荷中的 documentType 与 documentNumber 可能为 null。
• 身份、技术与状态区块在存在时返回；空数组或空对象表示该部分没有记录。
• 沙箱中 AA123BA 与 ABC10001–ABC10010 返回稳定的 200。ERR40401 返回 404 NotFound。
• 409 用于校验错误以及服务暂时不可用的情况。