RUNT — Vehículo (registro básico)

Service URL

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

La referencia canónica de contrato API está en inglés: /vehicle-validation/colombia/runt-vehiculo.

Consulta en RUNT la información del vehículo asociada a placa y titular (documentType + documentNumber). Pensado para registro, identidad y datos técnicos básicos; el informe histórico completo está en /v2/co/runt/vehicle-by-plate.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

Name	Type	Required	Description
documentType	string	Sí	Tipo de documento del titular: CC, CE, PA, NIT.
documentNumber	string	Sí	Número sin espacios ni signos.
plate	string	Sí	Placa (validación API: 5–9 caracteres).

Solicitud

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehiculo", {
	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/vehiculo"
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())

Respuesta

200

{
	"data": {
		"documentNumber": "31527228",
		"documentType": "CC",
		"plate": "WHH662",
		"vehicle": {
			"capacidadCarga": "0 KILO",
			"cilindraje": "4500",
			"clasificacion": "AUTOMOVIL",
			"color": "BLANCO VERDE",
			"estadoDelVehiculo": "ACTIVO",
			"linea": "T 45",
			"marca": "MAZDA",
			"modelo": "1999",
			"noChasis": "T45LB00445",
			"noPlaca": "WHH662",
			"numRegraSerie": "T45LB9900385RG",
			"organismoTransito": "STRIA DE TTOyTTE MEDELLIN",
			"tipoServicio": "Público",
			"toneladas": "0.00",
			"vehiculoEnsenanza": "NO"
		}
	},
	"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"
}

Notas

• documentType debe ser uno de CC, CE, PA, NIT (validado por la API).
• Para el historial completo de RUNT (SOAT, pólizas, registros, etc.), usa GET /v2/co/runt/vehicle-by-plate con los mismos tres parámetros de consulta.
• Para un perfil más ligero de placa y titular, consulta GET /v2/co/runt/vehicle-by-plate-simplified.