Skip to main content
Resolves a vehicle from RUNT (Registro Único Nacional de Tránsito), Colombia’s national traffic and vehicle registry. Given a plate and the registered owner’s document, it returns the vehicle’s registry record: make and model, technical specifications, identifiers, registering authority, dates, and lien/pledge flags. The owner’s document is required: RUNT only returns a vehicle when the plate and the document match an active owner.

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.
Like the lookup above, this is an async job.

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.
The response carries 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.
The response carries 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.