Simplified Vehicle Validation by License Plate in RUNT

Verifik’s Simplified Vehicle Validation API allows you to retrieve essential vehicle information from the Registro Único Nacional de Tránsito (RUNT) using the license plate and owner's document number.

This lightweight version of the vehicle query is designed for applications that need quick verification of vehicle identity and basic characteristics without the extensive data load of insurance and technical inspection history.

What information does the API return?

When a query is made, the API returns key vehicle details, including:

• Vehicle license plate number
• Make, model, and line
• Color and service type (e.g., Public, Private)
• Class (e.g., Automobile, Truck)
• Engine, chassis, and VIN numbers
• Registration status (Active)

This data is sufficient for basic identity verification and inventory management.

API Reference

Endpoint

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

A streamlined version of the vehicle background check from RUNT (Registro Único Nacional de Tránsito), focusing on essential legal and physical status markers. Pass documentType, documentNumber, and plate as query parameters.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

Name	Type	Required	Description
documentType	string	Yes	Owner document type. Allowed values: CC, CE, PA, NIT.
documentNumber	string	Yes	Owner’s document number, without spaces or periods.
plate	string	Yes	License plate to query (typically 5–9 characters per API validation rules).

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

• This simplified version provides essential vehicle information without detailed insurance and technical inspection data.
• Vehicle status "ACTIVO" means the vehicle is currently registered and operational.
• VIN (Vehicle Identification Number) and chassis numbers are provided for vehicle identification.
• This service is ideal for basic vehicle verification needs.

More information

The sections below are general product documentation (not part of the API contract).

---

Business Use Cases

The Simplified RUNT vehicle query API is ideal for:

• Parking Management: To verify vehicle details at entry/exit points.
• Logistics and Fleet Management: Quick registration of vehicles in internal systems.
• Auto Parts Stores: To confirm vehicle specifications for part compatibility.
• Toll Roads and Access Control: Fast validation of vehicle category.

Compliance & Data Quality

Compliance, availability, and accuracy

The API connects directly to official sources such as RUNT, ensuring:

• Verified and up-to-date information.
• High availability and optimal response times.
• Regulatory compliance with data protection laws.

Additional technical information

• Method: GET
• Response format: JSON
• Update frequency: Real-time
• Official source: RUNT Colombia
• Coverage: Nationwide

About Verifik

Verifik is an identity verification and compliance platform that connects companies with official data sources across Latin America.