RUNT — Veículo por placa (completo)
Endpoint
GET https://api.verifik.co/v2/co/runt/vehicle-by-plate
Consulta o histórico ampliado e o relatório técnico do veículo no RUNT com documentType, documentNumber e plate na query (SOAT, RC, TecnoMecánica, solicitações de trâmite quando disponíveis).
Cabeçalhos
| Nome | Valor |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
documentType | string | Sim | Tipo de documento do titular: CC, CE, PA ou NIT. |
documentNumber | string | Sim | Número do documento sem espaços nem pontos. |
plate | string | Sim | Placa (em geral 5–9 caracteres). |
Requisição
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehicle-by-plate", {
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/vehicle-by-plate"
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())
Resposta
- 200
- 404
- 409
{
"data": {
"informacionGeneral": {
"noLicenciaTransito": "10021312347",
"estadoDelVehiculo": "ACTIVO",
"tipoServicio": "Particular",
"claseVehiculo": "CAMIONETA",
"marca": "MAZDA",
"linea": "CX-30",
"modelo": "2021",
"color": "MACHINE GRAY",
"noMotor": "PY402912330",
"noChasis": "3MVDM2WLAML234946",
"noVin": "3MVDM2WLAML234946",
"cilidraje": "2488",
"tipoCarroceria": "WAGON",
"fechaMatricula": "17/10/2020",
"tieneGravamenes": "NO",
"organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
"prendas": "NO",
"clasificacion": "AUTOMOVIL",
"tipoCombustible": "GASOLINA",
"noPlaca": "ABC123",
"puertas": "5"
},
"datosTecnicos": {
"pesoBrutoVehicular": "1939",
"noEjes": "2",
"pasajerosSentados": "5"
},
"soat": [
{
"noPoliza": "355100023467200",
"fechaExpedicion": "03/10/2023",
"fechaVigencia": "17/10/2023",
"fechaVencimiento": "16/10/2024",
"entidadExpideSoat": "SEGUROS COMERCIALES BOLIVAR S.A",
"estado": "VIGENTE",
"tipoTarifa": "221"
}
],
"polizasResponsabilidadCivil": [],
"tecnoMecanica": [
{
"vigente": "NO APLICA"
}
],
"solicitudes": [
{
"noSolicitud": "124539870",
"fechaSolicitud": "17/10/2020",
"estado": "AUTORIZADA",
"tramitesRealizados": "Tramite matricula inicial",
"entidad": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA"
}
]
},
"signature": { "message": "Certified by Verifik.co", "dateTime": "March 14, 2024 2:23 PM" },
"id": "DWTV2"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType. missing documentNumber. missing plate"
}
Notas
- Retorno abrangente do RUNT: especificações técnicas e situação legal.
- SOAT: seguro obrigatório de acidentes de trânsito na Colômbia.
VIGENTE: exemplo de apólice ativa.ACTIVO: exemplo de veículo registrado e em circulação.