Requisição
POST /co/runt/vehicle-by-plate/v1
document_type corresponde a estes tipos de identidade: CC (cédula de ciudadanía), CE
(cédula de extranjería), TI (tarjeta de identidad), RC (registro civil), PA
(pasaporte), NIT e PPT (Permiso por Protección Temporal).
Resposta
Todas as seções além de
vehicle são entregues na medida do possível:
se uma seção não está disponível para um determinado veículo, ela é retornada
vazia ([] ou null) em vez de fazer a chamada falhar.
vehicle
Os indicadores
SI/NO são retornados como booleanos, os campos numéricos como
números e as datas como yyyy-mm-dd. Os valores ausentes são null.
soat_policies[]
Cada apólice de SOAT inclui policy_number, insurer, is_current (a
apólice atualmente vigente), issue_date, start_date, expiry_date, origin e
tariff_type.
inspections[]
Cada registro de técnico-mecânica (RTM) inclui certificate_number, center_name
(o CDA), inspection_type, status, is_current, issue_date, expiry_date
e plate.
specifications
load_capacity, gross_weight, axle_count, tire_count, height, width,
length, total_passengers, seated_passengers.
pledges[] e ownership_limitations[]
pledges lista as garantias registradas (creditor, creditor_document_type,
creditor_document_number, registered_date, trust_estate). Um veículo
financiado mostra aqui seu credor (p. ex. o banco que detém o penhor).
ownership_limitations lista as limitações à propriedade (limitation_type,
document_number, legal_entity, department, municipality, issue_date,
filing_date). Ambas ficam vazias para veículos sem gravames.
armoring, civil_liability[], certificados, normalization[], scrapping
armoring reporta o estado de blindagem: is_armored, level (p. ex. TRES),
level_number, armored_date, dearmored_date, resolution_number,
armoring_type, certificate_issue_date, authorization.
civil_liability[] lista as apólices de responsabilidade civil (policy_number,
insurer, start_date, expiry_date, is_current).
dijin_certificate e scrapping_certificate incluem certificate_number,
datas, entidade emissora e status. normalization[] reporta os registros de
normalização e scrapping reporta o estado de desintegração. Cada um é
null/vazio quando não se aplica ao veículo.
Esta consulta pode demorar mais do que uma requisição típica. É um
trabalho assíncrono. Por padrão a requisição aguarda de forma síncrona e retorna
{ data }, ou você pode definir Prefer: wait=N, consultar GET /jobs/{id} ou fornecer um
callback_url.Histórico do veículo por placa
POST /co/runt/vehicle-history-by-plate/v1
Consulta o histórico de um veículo no RUNT apenas com a placa, sem o
documento do proprietário. Retorna o proprietário ou proprietários registrados
com seu número de identificação, as características do veículo, os registros de
licença de trânsito e importação, o histórico de SOAT e técnico-mecânica, os
acidentes registrados, os trâmites recentes e vigentes, e os resumos de
garantias e limitações à propriedade.
found, plate, vehicle, owners[] (cada um com
document_type, name, document_number, datas de propriedade e owner_type),
traffic_license, import_record, soat_policies[], inspections[],
accident, pending_procedures[], guarantee e limitation. As seções são
entregues na medida do possível: o que não está disponível é retornado vazio
([] ou null) em vez de fazer a chamada falhar. Como a consulta anterior, é
um trabalho assíncrono.
Referência completa
Esquemas, campos de resposta e um playground interativo.