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.Veículo por VIN
POST /co/runt/vehicle-by-vin/v1
Consulta um veículo só pelo VIN (número único de identificação), sem placa nem
documento do proprietário. A resposta é a mesma ficha e as mesmas seções da
consulta acima, com vin ecoado e plate trazendo a placa registrada.
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, movable_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.
Cidadão por documento
POST /co/runt/citizen-by-document/v1
Consulta uma pessoa no RUNT apenas com seu documento de identidade. Retorna o
registro de condutor (nome, número e data de inscrição, situação da pessoa e do
condutor), cada carteira de habilitação com suas categorias, a situação de
multas (paz y salvo), as solicitações de trâmites, os certificados de aptidão e
médicos com seu detalhe, as inscrições CUPL, as validações SICOV, os pagamentos
ANSV e o histórico de validação de identidade. O primeiro sobrenome é opcional:
quando omitido, usa-se o que consta no registro.
As duas listas de certificados compartilham os campos de detalhe:
request_number,
request_date, fua_number, procedure, category, restrictions,
limitations, limitation_expiry_date, elements_to_overcome_limitations e
traffic_authority. Um certificado sem vencimento traz expiry_date: null.
As datas são yyyy-mm-dd e os valores ausentes são null. 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 as consultas anteriores,
é um trabalho assíncrono.
Cidadão por placa
POST /co/runt/citizen-by-plate/v1
Resolve o proprietário atual de um veículo apenas com a placa e retorna o
registro cidadão dessa pessoa: o mesmo registro de condutor, carteiras, multas,
solicitações, certificados, validações e pagamentos da consulta anterior.
found, plate, owner (document_type, document_number
e name do proprietário atual) e citizen, o registro do proprietário na forma
documentada acima. found é false com owner: null quando a placa não tem um
proprietário atual que seja pessoa física, por exemplo o veículo de uma empresa.
É um trabalho assíncrono.
Referência completa
Esquemas, campos de resposta e um playground interativo.