RUNT - Registros de veículo somente pela placa
Consulte informações oficiais de um veículo no RUNT usando somente a placa. Diferente de Veículo por placa (completo), este endpoint não exige documentType nem documentNumber do titular.
Use-o quando precisar dos blocos de identidade, técnicos e de status de uma placa colombiana sem o documento do proprietário.
O que a API retorna
informacionGeneral— placa, marca, linha, modelo, classe, serviço, status e campos de registro quando presentesdatosTecnicos— campos técnicos quando presentes- Blocos temporais como
soat[]etecnoMecanica[]quando presentes - Outros blocos RUNT (
solicitudes,polizasResponsabilidadCivile semelhantes) quando a resposta os inclui documentTypeedocumentNumberpodem sernull- Resposta assinada pela Verifik
Referência da API
Endpoint
GET https://api.verifik.co/v2/co/runt/vehicle-by-plate-only
Envie plate como parâmetro de consulta. O handler devolve a forma completa do veículo RUNT. As seções de identidade, técnicas e de status entram quando disponíveis. Os campos de documento do titular não são obrigatórios e podem voltar como null.
Cabeçalhos
| Nome | Valor |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parâmetros
| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
plate | string | Sim | Placa colombiana com 5 a 9 caracteres alfanuméricos. | AA123BA |
Solicitação
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehicle-by-plate-only", {
params: { plate: "AA123BA" },
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-only"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
response = requests.get(url, headers=headers, params={"plate": "AA123BA"})
print(response.json())
Resposta
- 200
- 404
- 409
- 409 (indisponível)
{
"data": {
"datosTecnicos": {
"noEjes": "2",
"pasajerosSentados": "5",
"pesoBrutoVehicular": "1650"
},
"documentNumber": null,
"documentType": null,
"garantiasFavorDe": [],
"garantiasMobiliarias": [],
"informacionBlindaje": {},
"informacionGeneral": {
"cilidraje": "1600",
"claseVehiculo": "AUTOMOVIL",
"clasificacion": "AUTOMOVIL",
"color": "BLANCO PERLA",
"estadoDelVehiculo": "ACTIVO",
"fechaMatricula": "15/03/2018",
"linea": "COROLLA",
"marca": "TOYOTA",
"modelo": "2020",
"noChasis": "9FB10000001",
"noLicenciaTransito": "110000001",
"noMotor": "MTR0000001",
"noPlaca": "AA123BA",
"noVin": "9FB10000001",
"organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
"prendas": "NO",
"puertas": "4",
"repotenciado": "NO",
"tarjetaRegistro": null,
"tarjetaServicio": "NO",
"tieneGravamenes": "NO",
"tipoCarroceria": "SEDAN",
"tipoCombustible": "GASOLINA",
"tipoServicio": "Particular"
},
"limitacionPropiedad": [],
"normalizacionSaneamiento": [],
"plate": "AA123BA",
"polizasResponsabilidadCivil": [],
"soat": [
{
"entidadExpideSoat": "SEGUROS DEL ESTADO S.A.",
"estado": "VIGENTE",
"fechaExpedicion": "01/01/2024",
"fechaVencimiento": "31/12/2024",
"fechaVigencia": "02/01/2024",
"noPoliza": "SOAT-000001",
"tipoTarifa": "221"
}
],
"solicitudes": [
{
"entidad": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
"estado": "AUTORIZADA",
"fechaSolicitud": "15/03/2018",
"noSolicitud": "110000001",
"tramitesRealizados": "Tramite matricula inicial"
}
],
"tarjetaOperacion": {},
"tecnoMecanica": [
{
"vigente": "SI"
}
],
"vin": "9FB10000001"
},
"signature": {
"dateTime": "September 16, 2026 8:00 PM",
"message": "Certified by Verifik.co"
},
"id": "ABCDE"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing plate"
}
{
"code": "Endpoint_out_of_service",
"message": "Endpoint_out_of_service"
}
Notas
- O código AppFeature é
colombia_api_runt_vehicle_by_plate_only. - Esta rota é a irmã somente-placa de GET
/v2/co/runt/vehicle-by-plate. Ela não aceitadocumentTypenemdocumentNumberdo titular. documentTypeedocumentNumberno payload podem sernull.- Os blocos de identidade, técnicos e de status voltam quando existem; arrays ou objetos vazios significam que a seção não tinha linhas.
- No sandbox,
AA123BAeABC10001–ABC10010devolvem 200 estáveis.ERR40401devolve 404NotFound. - 409 é usado para erros de validação e quando o serviço está temporariamente indisponível.