Validação simplificada de veículo por placa no 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.

O que a API retorna?

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.

Referência da API

Ponto de acesso

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

Cabeçalhos

Nome	Valor
Accept	application/json
Authorization	Bearer <token>

Parâmetros

Nome	Tipo	Obrigatório	Descrição
documentType	string	Sim	Tipo de documento. Valores permitidos: CC, CE, PA, NIT.
documentNumber	string	Sim	Número do documento do proprietário do veículo, sem espaços ou pontos.
plate	string	Sim	Placa do veículo a consultar.

Requisição

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())

Resposta

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."
}

Notas

• 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.

---

Casos de uso

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.

Conformidade e qualidade dos dados

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

Sobre a Verifik

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