Validação SOAT e RTM no 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.

O que a API retorna?

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.

Referência da API

Ponto de acesso

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

Cabeçalhos

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

Parâmetros

Nome	Tipo	Obrigatório	Descrição
documentType	string	Sim	Tipo de documento. Valores permitidos are: CC, CE, PA, RC, 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

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 <seu_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();
}

Resposta

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

---

Casos de uso

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.

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