RUNT — Véhicule par plaque (complet)

Endpoint

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

Interrogez le RUNT pour un historique étendu et un rapport technique via documentType, documentNumber et plate en paramètres de requête (SOAT, RC, contrôle technique, demandes d’immatriculation, etc., selon disponibilité).

En-têtes

Nom	Valeur
Accept	application/json
Authorization	Bearer <token>

Paramètres

Nom	Type	Obligatoire	Description
documentType	string	Oui	Type de document du titulaire : CC, CE, PA ou NIT.
documentNumber	string	Oui	Numéro du document sans espaces ni points.
plate	string	Oui	Plaque (souvent 5 à 9 caractères).

Requête

Node.js

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

Python

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

Réponse

200

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

404

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

409

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

Notes

• Réponse étendue : spécifications techniques et situation juridique.
• SOAT : assurance obligatoire accidents de la route en Colombie.
• VIGENTE : police d’assurance en vigueur (exemple).
• ACTIVO : véhicule immatriculé et en circulation (exemple).