Validation SOAT et RTM au RUNT

Verifik's SOAT and RTM Validation API provides real-time access to the status of mandatory documents for vehicles registered in Colombia: the Mandatory Traffic Accident Insurance (SOAT) and the Mechanical Technical Review (RTM).

This service is critical for ensuring that vehicles comply with Colombian traffic regulations, helping to prevent fines and legal issues.

Que renvoie l'API ?

When a query is made using the license plate and owner's document, the API returns:

• SOAT Status: Validity, policy number, insurer, issuance and expiration dates.
• RTM Status: Validity, certificate number, diagnostic center, issuance and expiration dates.
• Vehicle Details: Make, line, model, color, and registration status.
• Owner Verification: Confirmation of the document number associated with the vehicle.

Référence API

Point d'accès

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

En-têtes

Nom	Valeur
Content-Type	application/json
Authorization	Bearer <token>

Paramètres

Nom	Type	Requis	Description
documentType	string	Oui	Type de document. Valeurs autorisées are: CC, CE, PA, RC, NIT.
documentNumber	string	Oui	Numéro de document du propriétaire du véhicule, sans espaces ni points.
plate	string	Oui	Plaque du véhicule à consulter.

Requête

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: "Bearer <votre_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 = "https://api.verifik.co/v2/co/runt/consultarVehiculo?documentType=CC&documentNumber=98622259&plate=KBU003"
headers = {
  'Content-Type': 'text/plain'
}
conn.request("GET", "/v2/co/runt/vehiculo?documentType=CC&documentNumber=&plate=", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

let parameters = "https://api.verifik.co/v2/co/runt/consultarVehiculo?documentType=CC&documentNumber=98622259&plate=KBU003"
let postData = parameters.data(using: .utf8)

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/co/runt/vehiculo?documentType=CC&documentNumber=&plate=")!,timeoutInterval: Double.infinity)
request.addValue("text/plain", forHTTPHeaderField: "Content-Type")

request.httpMethod = "GET"
request.httpBody = postData

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=&plate=');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Content-Type' => 'text/plain'
));
$request->setBody('https://api.verifik.co/v2/co/runt/consultarVehiculo?documentType=CC&documentNumber=98622259&plate=KBU003');
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();
}

Réponse

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 - Invalid Document Type

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

---

Cas d'usage

The RUNT SOAT and RTM query API is widely used for:

• Insurance Companies: To verify current coverage before issuing new policies or processing claims.
• Fleet Management: To automatically monitor expiration dates and schedule renewals.
• Ride-Hailing Apps: To ensure that drivers' vehicles are legally compliant to operate.
• Traffic Authorities: To automate compliance checks and enforcement.

Conformité et qualité des données

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 traffic laws.

Additional technical information

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

À propos de Verifik

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