RUNT - Fiches véhicule par plaque uniquement

Interrogez les informations officielles RUNT d’un véhicule avec uniquement la plaque. Contrairement à Véhicule par plaque (complet), cet endpoint n’exige pas le documentType ni le documentNumber du titulaire.

Utilisez-le lorsque vous avez besoin des blocs d’identité, techniques et de statut d’une plaque colombienne sans le document du propriétaire.

Que renvoie l’API ?

• informacionGeneral — plaque, marque, ligne, modèle, classe, service, statut et champs d’immatriculation lorsqu’ils sont présents
• datosTecnicos — champs techniques lorsqu’ils sont présents
• Blocs temporels tels que soat[] et tecnoMecanica[] lorsqu’ils sont présents
• Autres blocs RUNT (solicitudes, polizasResponsabilidadCivil et similaires) lorsque la réponse les inclut
• documentType et documentNumber peuvent être null
• Réponse signée par Verifik

Référence API

Endpoint

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

Envoyez plate en paramètre de requête. Le handler renvoie la forme complète du véhicule RUNT. Les sections d’identité, techniques et de statut sont incluses lorsqu’elles sont disponibles. Les champs de document du titulaire ne sont pas obligatoires et peuvent revenir à null.

En-têtes

Nom	Valeur
Accept	application/json
Authorization	Bearer <token>

Paramètres

Nom	Type	Obligatoire	Description	Exemple
plate	string	Oui	Plaque colombienne de 5 à 9 caractères alphanumériques.	AA123BA

Requête

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehicle-by-plate-only", {
	params: { plate: "AA123BA" },
	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-only"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
response = requests.get(url, headers=headers, params={"plate": "AA123BA"})
print(response.json())

Réponse

200

{
	"data": {
		"datosTecnicos": {
			"noEjes": "2",
			"pasajerosSentados": "5",
			"pesoBrutoVehicular": "1650"
		},
		"documentNumber": null,
		"documentType": null,
		"garantiasFavorDe": [],
		"garantiasMobiliarias": [],
		"informacionBlindaje": {},
		"informacionGeneral": {
			"cilidraje": "1600",
			"claseVehiculo": "AUTOMOVIL",
			"clasificacion": "AUTOMOVIL",
			"color": "BLANCO PERLA",
			"estadoDelVehiculo": "ACTIVO",
			"fechaMatricula": "15/03/2018",
			"linea": "COROLLA",
			"marca": "TOYOTA",
			"modelo": "2020",
			"noChasis": "9FB10000001",
			"noLicenciaTransito": "110000001",
			"noMotor": "MTR0000001",
			"noPlaca": "AA123BA",
			"noVin": "9FB10000001",
			"organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
			"prendas": "NO",
			"puertas": "4",
			"repotenciado": "NO",
			"tarjetaRegistro": null,
			"tarjetaServicio": "NO",
			"tieneGravamenes": "NO",
			"tipoCarroceria": "SEDAN",
			"tipoCombustible": "GASOLINA",
			"tipoServicio": "Particular"
		},
		"limitacionPropiedad": [],
		"normalizacionSaneamiento": [],
		"plate": "AA123BA",
		"polizasResponsabilidadCivil": [],
		"soat": [
			{
				"entidadExpideSoat": "SEGUROS DEL ESTADO S.A.",
				"estado": "VIGENTE",
				"fechaExpedicion": "01/01/2024",
				"fechaVencimiento": "31/12/2024",
				"fechaVigencia": "02/01/2024",
				"noPoliza": "SOAT-000001",
				"tipoTarifa": "221"
			}
		],
		"solicitudes": [
			{
				"entidad": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
				"estado": "AUTORIZADA",
				"fechaSolicitud": "15/03/2018",
				"noSolicitud": "110000001",
				"tramitesRealizados": "Tramite matricula inicial"
			}
		],
		"tarjetaOperacion": {},
		"tecnoMecanica": [
			{
				"vigente": "SI"
			}
		],
		"vin": "9FB10000001"
	},
	"signature": {
		"dateTime": "September 16, 2026 8:00 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "ABCDE"
}

404

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

409

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

409 (indisponible)

{
	"code": "Endpoint_out_of_service",
	"message": "Endpoint_out_of_service"
}

Notes

• Le code AppFeature est colombia_api_runt_vehicle_by_plate_only.
• Cette route est la sœur « plaque seule » de GET /v2/co/runt/vehicle-by-plate. Elle n’accepte pas le documentType ni le documentNumber du titulaire.
• documentType et documentNumber du payload peuvent être null.
• Les blocs d’identité, techniques et de statut sont renvoyés lorsqu’ils existent ; un tableau ou un objet vide signifie que la section n’avait aucune ligne.
• Dans le sandbox, AA123BA et ABC10001–ABC10010 renvoient des 200 stables. ERR40401 renvoie 404 NotFound.
• 409 est utilisé pour les erreurs de validation et lorsque le service est temporairement indisponible.