Solicitud
POST /co/runt/vehicle-by-plate/v1
document_type corresponde a estos tipos de identidad: CC (cédula de ciudadanía), CE
(cédula de extranjería), TI (tarjeta de identidad), RC (registro civil), PA
(pasaporte), NIT y PPT (Permiso por Protección Temporal).
Respuesta
Todas las secciones más allá de
vehicle se entregan en la medida de lo posible:
si una sección no está disponible para un vehículo determinado, se devuelve vacía
([] o null) en lugar de hacer fallar la llamada.
vehicle
Los indicadores
SI/NO se devuelven como booleanos, los campos numéricos como
números y las fechas como yyyy-mm-dd. Los valores faltantes son null.
soat_policies[]
Cada póliza de SOAT incluye policy_number, insurer, is_current (la
póliza actualmente vigente), issue_date, start_date, expiry_date, origin y
tariff_type.
inspections[]
Cada registro de técnico-mecánica (RTM) incluye certificate_number, center_name
(el CDA), inspection_type, status, is_current, issue_date, expiry_date
y plate.
specifications
load_capacity, gross_weight, axle_count, tire_count, height, width,
length, total_passengers, seated_passengers.
pledges[] y ownership_limitations[]
pledges lista las garantías registradas (creditor, creditor_document_type,
creditor_document_number, registered_date, trust_estate). Un vehículo
financiado muestra aquí a su acreedor (p. ej. el banco que tiene la prenda).
ownership_limitations lista las limitaciones a la propiedad (limitation_type,
document_number, legal_entity, department, municipality, issue_date,
filing_date). Ambas quedan vacías para vehículos sin gravámenes.
armoring, civil_liability[], certificados, normalization[], scrapping
armoring reporta el estado de blindaje: is_armored, level (p. ej. TRES),
level_number, armored_date, dearmored_date, resolution_number,
armoring_type, certificate_issue_date, authorization.
civil_liability[] lista las pólizas de responsabilidad civil (policy_number,
insurer, start_date, expiry_date, is_current).
dijin_certificate y scrapping_certificate incluyen certificate_number,
fechas, entidad emisora y status. normalization[] reporta los registros de
normalización y scrapping reporta el estado de desintegración. Cada uno es
null/vacío cuando no aplica al vehículo.
Esta consulta puede tardar más que una solicitud típica. Es un
trabajo asíncrono. Por defecto la solicitud espera en línea y devuelve
{ data }, o puedes establecer Prefer: wait=N, consultar GET /jobs/{id} o proporcionar un
callback_url.Historial del vehículo por placa
POST /co/runt/vehicle-history-by-plate/v1
Consulta el historial de un vehículo en el RUNT solo con la placa, sin el
documento del propietario. Devuelve el o los propietarios registrados con su
número de identificación, las características del vehículo, los registros de
licencia de tránsito e importación, el historial de SOAT y técnico-mecánica, los
accidentes registrados, los trámites recientes y vigentes, y los resúmenes de
garantías y limitaciones a la propiedad.
found, plate, vehicle, owners[] (cada uno con
document_type, name, document_number, fechas de propiedad y owner_type),
traffic_license, import_record, soat_policies[], inspections[],
accident, pending_procedures[], guarantee y limitation. Las secciones se
entregan en la medida de lo posible: lo no disponible se devuelve vacío ([] o
null) en lugar de hacer fallar la llamada. Como la consulta anterior, es un
trabajo asíncrono.
Referencia completa
Esquemas, campos de respuesta y un playground interactivo.