> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# RUNT
> Resolve a Colombian vehicle in RUNT by plate and the registered owner's document.
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). |
```bash theme={"dark"}
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](/async-jobs). 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). |
```bash theme={"dark"}
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.
Schemas, response fields, and an interactive playground.