Request
POST /co/runt/vehicle-by-plate/v1
document_type maps to these identity types: CC (cédula de ciudadanía), CE
(cédula de extranjería), TI (tarjeta de identidad), RC (registro civil), PA
(pasaporte), NIT, and PPT (Permiso por Protección Temporal).
Response
All sections beyond
vehicle are best-effort: if a section is unavailable for a
given vehicle it comes back empty ([] or null) rather than failing the call.
vehicle
SI/NO indicators are returned as booleans, numeric fields as numbers, and
dates as yyyy-mm-dd. Missing values are null.
soat_policies[]
Each SOAT policy carries policy_number, insurer, is_current (the
currently-valid policy), issue_date, start_date, expiry_date, origin, and
tariff_type.
inspections[]
Each técnico-mecánica (RTM) record carries certificate_number, center_name
(the CDA), inspection_type, status, is_current, issue_date, expiry_date,
and plate.
specifications
load_capacity, gross_weight, axle_count, tire_count, height, width,
length, total_passengers, seated_passengers.
pledges[] and ownership_limitations[]
pledges lists registered guarantees/liens (garantías): creditor,
creditor_document_type, creditor_document_number, registered_date,
trust_estate. A financed vehicle shows its creditor here (e.g. the bank that
holds the prenda). ownership_limitations lists limitaciones a la propiedad
(limitation_type, document_number, legal_entity, department,
municipality, issue_date, filing_date). Both are empty for unencumbered
vehicles.
armoring, civil_liability[], certificates, normalization[], scrapping
armoring reports blindaje status: is_armored, level (e.g. TRES),
level_number, armored_date, dearmored_date, resolution_number,
armoring_type, certificate_issue_date, authorization.
civil_liability[] lists responsabilidad-civil policies (policy_number,
insurer, start_date, expiry_date, is_current).
dijin_certificate and scrapping_certificate carry a certificate_number,
dates, issuing entity, and status. normalization[] reports normalización
records, and scrapping reports desintegración status. Each is null/empty when
not applicable to the vehicle.
This lookup can take longer than a typical request. It’s an
async job. By default the request waits inline and returns
{ data }, or you can set Prefer: wait=N, poll GET /jobs/{id}, or supply a
callback_url.Vehicle by VIN
POST /co/runt/vehicle-by-vin/v1
Looks up a vehicle by its VIN (número único de identificación) alone, with no
plate and no owner document. The answer is the same record and sections as the
lookup above, with vin echoed and plate carrying the registered plate.
Vehicle history by plate
POST /co/runt/vehicle-history-by-plate/v1
Looks up a vehicle’s RUNT history by plate alone, without the owner’s document.
It returns the registered owner(s) with their identification numbers, the vehicle
characteristics, the traffic-license and import records, SOAT and técnico-mecánica
history, any accident on record, recent and pending procedures (trámites), and
guarantee/lien and ownership-limitation summaries.
found, plate, vehicle, owners[] (each with
document_type, name, document_number, ownership dates, and owner_type),
traffic_license, import_record, soat_policies[], inspections[],
accident, pending_procedures[], guarantee, movable_guarantee, and limitation. Sections are
best-effort: anything unavailable comes back empty ([] or null) rather than
failing the call. Like the lookup above, this is an async job.
owners[] lists the owners RUNT publishes for the plate, which is normally the
current one (ownership_end_date is null). Earlier ownership changes show up
as transfer procedures (TRÁMITE TRASPASO) with their dates in
pending_procedures[]. When the owner is a company (document_type is NIT),
name is its legal name as registered in RUES, or null when the NIT is not
registered there.
Citizen by document
POST /co/runt/citizen-by-document/v1
Looks up a person in RUNT by identification document alone. It returns the
driver record (name, registration id and date, person and driver status), every
driving licence with its categories, traffic-fine standing (paz y salvo),
procedure requests (solicitudes), driving-aptitude and medical certificates with
their detail, CUPL registrations, SICOV validations, ANSV payments and the
identity-validation history. The first surname is optional: when omitted, the
surname on record is used.
Both certificate lists carry the same detail fields:
request_number,
request_date, fua_number, procedure, category, restrictions,
limitations, limitation_expiry_date, elements_to_overcome_limitations and
traffic_authority. A certificate with no expiry has expiry_date: null. Dates
are yyyy-mm-dd and missing values are null. Sections are best-effort:
anything unavailable comes back empty ([] or null) rather than failing the
call. Like the lookups above, this is an async job.
Citizen by plate
POST /co/runt/citizen-by-plate/v1
Resolves a vehicle’s current registered owner from the plate alone and returns
that person’s citizen record: the same driver record, licences, fines,
requests, certificates, validations and payments as the lookup above.
found, plate, owner (document_type,
document_number and name of the current owner) and citizen, the owner’s
record in the shape documented above. found is false with owner: null when
the plate has no current natural-person owner, for example a company’s vehicle.
This is an async job.
Full reference
Schemas, response fields, and an interactive playground.