🇨🇴 RUNT — 번호판별 차량（간편·별칭）

엔드포인트

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

차량 이력 조회의 간편 버전으로, 보험·검사 이력보다 법적·물리적 핵심 지표를 빠르게 확인할 때 쓰입니다. 쿼리로 documentType, documentNumber, plate 를 보냅니다.

헤더(Headers)

Name	Value
Accept	application/json
Authorization	Bearer <token>

매개변수(Parameters)

name	type	required	description
documentType	string	yes	소유자 신분증 유형. CC, CE, PA, NIT 중 하나.
documentNumber	string	yes	소유자 문서 번호(공백·마침표 없음).
plate	string	yes	조회할 번호판(API 검증 규칙상 보통 5–9자).

요청(Request)

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehicle-by-plate-simplified", {
	params: {
		documentType: "CC",
		documentNumber: "123456789",
		plate: "ABC123",
	},
	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-simplified"
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())

응답(Response)

200

{
	"data": {
		"documentNumber": "31527228",
		"documentType": "CC",
		"plate": "WHH662",
		"vehicle": {
			"capacidadCarga": "0 KILO",
			"cilindraje": "4500",
			"clasificacion": "AUTOMOVIL",
			"color": "BLANCO VERDE",
			"diasMatriculado": "6686",
			"esRegrabadoChasis": "NO",
			"esRegrabadoMotor": "NO",
			"esRegrabadoSerie": "SI",
			"esRegrabadoVin": "NO",
			"homologaciones": [],
			"idTipoServicio": "2",
			"linea": "T 45",
			"marca": "MAZDA",
			"modelo": "1999",
			"mostrarSolicitudes": "SI",
			"noChasis": "T45LB00445",
			"noPlaca": "WHH662",
			"numRegraSerie": "T45LB9900385RG",
			"organismoTransito": "STRIA DE TTOyTTE MEDELLIN",
			"pasajerosSentados": "30",
			"pesoBruto": null,
			"prendas": "NO",
			"puertas": "2",
			"repotenciado": "NO",
			"seguridadEstado": "NO",
			"tarjetaServicio": "SI",
			"tieneLTImportacion": true,
			"tipoCarroceria": "CERRADA",
			"tipoCombustible": "DIESEL",
			"tipoServicio": "Público",
			"toneladas": "0.00",
			"validacionDIAN": "Exitoso",
			"vehiculoEnsenanza": "NO",
			"verValidaDIAN": false
		}
	},
	"signature": {
		"dateTime": "October 10, 2025 8:10 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "GVMFW"
}

404

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

409

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

{
	"code": "MissingParameter",
	"message": "documentType must be one of: [CC, CE, PA, NIT]"
}

{
	"code": "MissingParameter",
	"message": "missing documentNumber\n"
}

{
	"code": "MissingParameter",
	"message": "missing documentType\n"
}

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

500

{
	"code": "InternalServerError",
	"message": "Server error."
}

참고(Notes)

• 상세 조회와 달리 보험·검사 이력 등 전체 데이터는 포함하지 않는 간단 응답입니다.
• ACTIVO 는 등록이 유효하고 운행 가능한 상태의 예시입니다.
• VIN·샤시 번호 등으로 차량을 식별할 수 있습니다.
• 빠른 차량 확인·출입 통제에 적합합니다.