Validación de SOAT y RTM en RUNT (Colombia)

La API de Validación de SOAT y RTM de Verifik proporciona acceso en tiempo real al estado de los documentos obligatorios para vehículos registrados en Colombia: el Seguro Obligatorio de Accidentes de Tránsito (SOAT) y la Revisión Técnico-Mecánica (RTM).

Este servicio es crítico para asegurar que los vehículos cumplan con la normativa de tránsito colombiana, ayudando a prevenir multas y problemas legales.

¿Qué información devuelve la API?

Al realizar una consulta utilizando la placa y el documento del propietario, la API retorna:

• Estado del SOAT: Vigencia, número de póliza, aseguradora, fechas de expedición y vencimiento.
• Estado de la RTM: Vigencia, número de certificado, centro de diagnóstico, fechas de expedición y vencimiento.
• Detalles del Vehículo: Marca, línea, modelo, color y estado del registro.
• Verificación del Propietario: Confirmación del número de documento asociado al vehículo.

Referencia de API

Endpoint

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

El servicio de Información de Vehículos Colombianos proporciona acceso en tiempo real a detalles sobre un vehículo registrado en Colombia. Utilizando este servicio, puedes obtener información como el nombre e identificación del propietario, color del vehículo, marca y modelo, estado de registro, y fechas de vencimiento del SOAT (seguro obligatorio de accidentes de tránsito) y revisión técnica.

Este servicio es ideal para empresas de la industria automotriz, compañías de seguros y agencias gubernamentales que necesitan verificar información de vehículos y asegurar el cumplimiento de regulaciones.

Headers

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
documentType	string	Sí	Tipo de documento. Valores permitidos son: CC, CE, PA, RC, NIT.
documentNumber	string	Sí	Número de documento del propietario del vehículo, sin espacios ni puntos.
plate	string	Sí	Placa del vehículo a consultar.

Solicitud

JavaScript

import axios from "axios";

const options = {
	method: "GET",
	url: "https://api.verifik.co/v2/co/runt/vehiculo",
	params: { documentType: "CC", documentNumber: "123456789", plate: "ABC123" },
	headers: {
		Accept: "application/json",
		Authorization: "jwt <tu_token>",
	},
};

try {
	const { data } = await axios.request(options);
	console.log(data);
} catch (error) {
	console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/co/runt/vehiculo?documentType=CC&documentNumber=123456789&plate=ABC123", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/co/runt/vehiculo?documentType=CC&documentNumber=123456789&plate=ABC123")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/co/runt/vehiculo?documentType=CC&documentNumber=123456789&plate=ABC123');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
?>

Respuesta

200

{
	"data": {
		"documentType": "CC",
		"documentNumber": "123456789",
		"plate": "XXXXX",
		"vehicleInformation": {
			"color": "PLATEADO",
			"brand": "CHERY",
			"line": "QQ3 SQR7080 S116",
			"status": "ACTIVO",
			"enrollmentDate": "07/10/2010",
			"plate": "XXXXX"
		},
		"soat": {
			"valid": true,
			"expeditionDate": "10/09/2021",
			"dueDate": "11/09/2022",
			"coverageStartDate": "12/09/2021",
			"soatNumber": "XXXXXX"
		},
		"techReview": {
			"valid": true,
			"reviewNumber": "XXXXX",
			"expeditionDate": "12/09/2021",
			"dueDate": "12/09/2022",
			"requireTechReview": true
		},
		"consultationDateTime": "2022-03-03T17:10:00.568Z"
	},
	"signature": {
		"dateTime": "March 3, 2022 12:10 PM",
		"message": "Certified by Verifik.co"
	}
}

404

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

409

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

409 - Tipo de Documento Inválido

{
	"code": "MissingParameter",
	"message": "documentType must be one of: [CC]"
}

---

Casos de Uso Empresariales

La API de consulta de SOAT y RTM en RUNT es utilizada por múltiples sectores:

• Verificación de Vehículos: Validar información completa de vehículos registrados en Colombia
• Servicios de Seguros: Verificar estado del SOAT y fechas de vencimiento
• Revisión Técnica: Validar estado de la revisión técnica vehicular
• Control de Tránsito: Verificar cumplimiento de regulaciones vehiculares
• Empresas de Transporte: Validar flotas vehiculares y sus documentos
• Verificación de Propiedad: Confirmar datos del propietario y del vehículo

Cumplimiento y Calidad de Datos

Cumplimiento, disponibilidad y precisión

La API se conecta directamente con fuentes oficiales como el RUNT, garantizando:

• Información verificada y actualizada.
• Alta disponibilidad y tiempos de respuesta óptimos.
• Cumplimiento normativo con leyes de tránsito.

Información técnica adicional

• Método: GET
• Formato de respuesta: JSON
• Frecuencia de actualización: Tiempo real
• Fuente oficial: RUNT Colombia
• Cobertura: Nacional

Sobre Verifik

Verifik es una plataforma de verificación de identidad y cumplimiento que conecta empresas con fuentes oficiales en toda América Latina.