RUNT — 按车牌查询车辆(完整)
端点
GET https://api.verifik.co/v2/co/runt/vehicle-by-plate
使用 documentType、documentNumber、plate 查询参数 从 RUNT 获取车辆的完整历史与技术报告(SOAT、第三者责任险、年检、登记申请等,视数据返回情况而定)。
请求头
| 名称 | 值 |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
documentType | string | 是 | 车主证件类型:CC、CE、PA、NIT 之一。 |
documentNumber | string | 是 | 车主证件号码(无空格和句号)。 |
plate | string | 是 | 车牌(通常 5–9 位)。 |
请求
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehicle-by-plate", {
params: {
documentType: "CC",
documentNumber: "123456789",
plate: "ABC123",
},
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/runt/vehicle-by-plate"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789", "plate": "ABC123"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
响应
- 200
- 404
- 409
{
"data": {
"informacionGeneral": {
"noLicenciaTransito": "10021312347",
"estadoDelVehiculo": "ACTIVO",
"tipoServicio": "Particular",
"claseVehiculo": "CAMIONETA",
"marca": "MAZDA",
"linea": "CX-30",
"modelo": "2021",
"color": "MACHINE GRAY",
"noMotor": "PY402912330",
"noChasis": "3MVDM2WLAML234946",
"noVin": "3MVDM2WLAML234946",
"cilidraje": "2488",
"tipoCarroceria": "WAGON",
"fechaMatricula": "17/10/2020",
"tieneGravamenes": "NO",
"organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
"prendas": "NO",
"clasificacion": "AUTOMOVIL",
"tipoCombustible": "GASOLINA",
"noPlaca": "ABC123",
"puertas": "5"
},
"datosTecnicos": {
"pesoBrutoVehicular": "1939",
"noEjes": "2",
"pasajerosSentados": "5"
},
"soat": [
{
"noPoliza": "355100023467200",
"fechaExpedicion": "03/10/2023",
"fechaVigencia": "17/10/2023",
"fechaVencimiento": "16/10/2024",
"entidadExpideSoat": "SEGUROS COMERCIALES BOLIVAR S.A",
"estado": "VIGENTE",
"tipoTarifa": "221"
}
],
"polizasResponsabilidadCivil": [],
"tecnoMecanica": [
{
"vigente": "NO APLICA"
}
],
"solicitudes": [
{
"noSolicitud": "124539870",
"fechaSolicitud": "17/10/2020",
"estado": "AUTORIZADA",
"tramitesRealizados": "Tramite matricula inicial",
"entidad": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA"
}
]
},
"signature": { "message": "Certified by Verifik.co", "dateTime": "March 14, 2024 2:23 PM" },
"id": "DWTV2"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType. missing documentNumber. missing plate"
}
说明
- RUNT 返回含技术参数与法律状态的广泛信息。
- SOAT 为哥伦比亚强制交通事故保险。
VIGENTE表示保险有效(示例)。ACTIVO表示登记有效、可上路(示例)。