RUNT

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

Field	Type	Notes
`plate`	string	Required. Vehicle plate, e.g. `GHW899` (cars) or `ABC12D` (motorcycles).
`document_type`	string	Optional. One of `CC`, `CE`, `TI`, `RC`, `PA`, `NIT`, `PPT`. Defaults to `CC`.
`document_number`	string	Required. The registered owner’s document number (3-30 alphanumeric characters).

curl https://api.croma.run/co/runt/vehicle-by-plate/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "plate": "GHW899", "document_type": "CC", "document_number": "1000410698" }'

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

Field	Notes
`found`	`true` when the plate and owner document have an active match; `false` leaves `vehicle` null and the lists empty.
`plate`	The queried plate (uppercased).
`vehicle`	The vehicle registry record (see below), or `null` when not found.
`soat_policies`	SOAT insurance policy history (newest first).
`inspections`	Técnico-mecánica (RTM) inspection history.
`specifications`	Extended specifications (dimensions, weights, capacities), or `null`.
`pledges`	Registered guarantees/liens (garantías), including the creditor (e.g. a financing bank).
`ownership_limitations`	Ownership limitations (limitaciones a la propiedad).
`armoring`	Armoring (blindaje) status and level, or `null` when unarmored.
`civil_liability`	Civil-liability (responsabilidad civil) policies.
`dijin_certificate`	DIJIN certificate, or `null` when none on record.
`scrapping_certificate`	Scrapping certificate (certificado de desintegración), or `null`.
`normalization`	Normalization (normalización) records.
`scrapping`	Scrapping (desintegración) status, or `null`.

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`

Field	Notes
`plate`	The vehicle’s plate.
`registration_status`	Registration status, e.g. `ACTIVO`.
`service_type`	Service type, e.g. `Particular` / `Público`.
`vehicle_class`, `classification`, `body_type`	Class (e.g. `AUTOMOVIL`), classification, and body type.
`brand`, `line`, `model_year`, `color`	Make, line, model year, and color.
`fuel_type`, `engine_displacement`	Fuel type and engine displacement (cc).
`doors`, `seated_passengers`, `total_passengers`	Doors and passenger capacity.
`axle_count`, `gross_weight`, `load_capacity`	Axles, gross weight, and load capacity.
`vin`, `engine_number`, `chassis_number`, `serial_number`	Vehicle identifiers.
`traffic_license_number`	Traffic-license number (licencia de tránsito).
`traffic_authority`	Registering traffic authority (organismo de tránsito).
`country_name`	Origin country, when applicable.
`registration_date`, `enrollment_date`, `days_registered`	Registration dates and days registered.
`has_liens`, `has_pledges`	Whether the vehicle carries registered liens (gravámenes) or pledges (prendas).
`is_repowered`, `is_classic`, `is_teaching_vehicle`, `is_state_security`	Status flags.
`engine_restamped`, `chassis_restamped`, `serial_restamped`, `vin_restamped`	Whether each identifier was re-stamped (regrabado).

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 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.

Field	Type	Notes
`plate`	string	Required. Vehicle plate, e.g. `GHW899` (cars) or `ABC12D` (motorcycles).

curl https://api.croma.run/co/runt/vehicle-history-by-plate/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "plate": "GHW899" }'

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, 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.

Full reference

Schemas, response fields, and an interactive playground.

Get Started

Colombia

Peru

Global

Request

Response

`vehicle`

`soat_policies[]`

`inspections[]`

`specifications`

`pledges[]` and `ownership_limitations[]`

`armoring`, `civil_liability[]`, certificates, `normalization[]`, `scrapping`

Vehicle history by plate

Full reference

​Request

​Response

​vehicle

​soat_policies[]

​inspections[]

​specifications

​pledges[] and ownership_limitations[]

​armoring, civil_liability[], certificates, normalization[], scrapping

​Vehicle history by plate

Full reference

Request

Response

`vehicle`

`soat_policies[]`

`inspections[]`

`specifications`

`pledges[]` and `ownership_limitations[]`

`armoring`, `civil_liability[]`, certificates, `normalization[]`, `scrapping`

Vehicle history by plate