RUNT - Vehicle registration (basic)
Endpoint
GET https://api.verifik.co/v2/co/runt/vehiculo
Returns RUNT vehicle data for Colombia tied to the license plate and the holder’s identification (documentType + documentNumber). The response is oriented toward registration, identity, and basic technical markers (SOAT / technical inspection summaries may appear when present in the formatted payload), not the full historical “complete report” available on /v2/co/runt/vehicle-by-plate.
Optional audit query flag (boolean strings such as true / false) when supported by your integration.
Headers
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
documentType | string | Yes | Holder document type. Allowed values: CC, CE, PA, NIT. |
documentNumber | string | Yes | Holder document number, without spaces or punctuation. |
plate | string | Yes | License plate to query (API validation: 5–9 characters). Plates are normalized to uppercase server-side. |
Request
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehiculo", {
params: {
documentType: "CC",
documentNumber: "123456789",
plate: "ABC123",
},
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/runt/vehiculo"
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())
Response
- 200
- 404
- 409
{
"data": {
"documentNumber": "31527228",
"documentType": "CC",
"plate": "WHH662",
"vehicle": {
"capacidadCarga": "0 KILO",
"cilindraje": "4500",
"clasificacion": "AUTOMOVIL",
"color": "BLANCO VERDE",
"estadoDelVehiculo": "ACTIVO",
"linea": "T 45",
"marca": "MAZDA",
"modelo": "1999",
"noChasis": "T45LB00445",
"noPlaca": "WHH662",
"numRegraSerie": "T45LB9900385RG",
"organismoTransito": "STRIA DE TTOyTTE MEDELLIN",
"tipoServicio": "Público",
"toneladas": "0.00",
"vehiculoEnsenanza": "NO"
}
},
"signature": {
"dateTime": "October 10, 2025 8:10 PM",
"message": "Certified by Verifik.co"
},
"id": "GVMFW"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType. missing documentNumber. missing plate"
}
Notes
documentTypemust be one ofCC,CE,PA,NIT(validated by the API).- For the full RUNT history (SOAT, policies, registrations, etc.), use
GET /v2/co/runt/vehicle-by-platewith the same three query parameters. - For a lighter plate + owner profile, see
GET /v2/co/runt/vehicle-by-plate-simplified.