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

> Resuelve un vehículo colombiano en el RUNT por placa y el documento del propietario registrado.

Resuelve un vehículo del RUNT (Registro Único Nacional de Tránsito), el registro
nacional de tránsito y vehículos de Colombia. Dada una placa y el documento del
propietario registrado, devuelve el registro del vehículo en el RUNT: marca y
modelo, especificaciones técnicas, identificadores, autoridad de registro, fechas
e indicadores de gravámenes y prendas.

El documento del propietario es obligatorio: el RUNT solo devuelve un vehículo
cuando la placa y el documento corresponden a un propietario activo.

## Solicitud

`POST /co/runt/vehicle-by-plate/v1`

| Campo             | Tipo   | Notas                                                                                                    |
| ----------------- | ------ | -------------------------------------------------------------------------------------------------------- |
| `plate`           | string | **Obligatorio.** Placa del vehículo, p. ej. `GHW899` (carros) o `ABC12D` (motos).                        |
| `document_type`   | string | Opcional. Uno de `CC`, `CE`, `TI`, `RC`, `PA`, `NIT`, `PPT`. Por defecto es `CC`.                        |
| `document_number` | string | **Obligatorio.** Número de documento del propietario registrado (entre 3 y 30 caracteres alfanuméricos). |

```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` corresponde a estos tipos de identidad: `CC` (cédula de ciudadanía), `CE`
(cédula de extranjería), `TI` (tarjeta de identidad), `RC` (registro civil), `PA`
(pasaporte), `NIT` y `PPT` (Permiso por Protección Temporal).

## Respuesta

| Campo                   | Notas                                                                                                                                     |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `found`                 | `true` cuando la placa y el documento del propietario tienen una coincidencia activa; `false` deja `vehicle` en null y las listas vacías. |
| `plate`                 | La placa consultada (en mayúsculas).                                                                                                      |
| `vehicle`               | El registro del vehículo en el RUNT (ver abajo), o `null` cuando no se encuentra.                                                         |
| `soat_policies`         | Historial de pólizas de SOAT (las más recientes primero).                                                                                 |
| `inspections`           | Historial de revisiones técnico-mecánicas (RTM).                                                                                          |
| `specifications`        | Especificaciones ampliadas (dimensiones, pesos, capacidades), o `null`.                                                                   |
| `pledges`               | Garantías registradas (garantías/prendas), incluido el acreedor (p. ej. un banco que financia).                                           |
| `ownership_limitations` | Limitaciones a la propiedad.                                                                                                              |
| `armoring`              | Estado y nivel de blindaje, o `null` cuando no está blindado.                                                                             |
| `civil_liability`       | Pólizas de responsabilidad civil.                                                                                                         |
| `dijin_certificate`     | Certificado DIJIN, o `null` cuando no hay registro.                                                                                       |
| `scrapping_certificate` | Certificado de desintegración, o `null`.                                                                                                  |
| `normalization`         | Registros de normalización.                                                                                                               |
| `scrapping`             | Estado de desintegración, o `null`.                                                                                                       |

Todas las secciones más allá de `vehicle` se entregan en la medida de lo posible:
si una sección no está disponible para un vehículo determinado, se devuelve vacía
(`[]` o `null`) en lugar de hacer fallar la llamada.

### `vehicle`

| Campo                                                                        | Notas                                                           |
| ---------------------------------------------------------------------------- | --------------------------------------------------------------- |
| `plate`                                                                      | La placa del vehículo.                                          |
| `registration_status`                                                        | Estado del registro, p. ej. `ACTIVO`.                           |
| `service_type`                                                               | Tipo de servicio, p. ej. `Particular` / `Público`.              |
| `vehicle_class`, `classification`, `body_type`                               | Clase (p. ej. `AUTOMOVIL`), clasificación y tipo de carrocería. |
| `brand`, `line`, `model_year`, `color`                                       | Marca, línea, año del modelo y color.                           |
| `fuel_type`, `engine_displacement`                                           | Tipo de combustible y cilindrada del motor (cc).                |
| `doors`, `seated_passengers`, `total_passengers`                             | Puertas y capacidad de pasajeros.                               |
| `axle_count`, `gross_weight`, `load_capacity`                                | Ejes, peso bruto y capacidad de carga.                          |
| `vin`, `engine_number`, `chassis_number`, `serial_number`                    | Identificadores del vehículo.                                   |
| `traffic_license_number`                                                     | Número de la licencia de tránsito.                              |
| `traffic_authority`                                                          | Organismo de tránsito que realizó el registro.                  |
| `country_name`                                                               | País de origen, cuando aplica.                                  |
| `registration_date`, `enrollment_date`, `days_registered`                    | Fechas de registro y días registrado.                           |
| `has_liens`, `has_pledges`                                                   | Si el vehículo tiene gravámenes o prendas registradas.          |
| `is_repowered`, `is_classic`, `is_teaching_vehicle`, `is_state_security`     | Indicadores de estado.                                          |
| `engine_restamped`, `chassis_restamped`, `serial_restamped`, `vin_restamped` | Si cada identificador fue regrabado.                            |

Los indicadores `SI`/`NO` se devuelven como booleanos, los campos numéricos como
números y las fechas como `yyyy-mm-dd`. Los valores faltantes son `null`.

### `soat_policies[]`

Cada póliza de SOAT incluye `policy_number`, `insurer`, `is_current` (la
póliza actualmente vigente), `issue_date`, `start_date`, `expiry_date`, `origin` y
`tariff_type`.

### `inspections[]`

Cada registro de técnico-mecánica (RTM) incluye `certificate_number`, `center_name`
(el CDA), `inspection_type`, `status`, `is_current`, `issue_date`, `expiry_date`
y `plate`.

### `specifications`

`load_capacity`, `gross_weight`, `axle_count`, `tire_count`, `height`, `width`,
`length`, `total_passengers`, `seated_passengers`.

### `pledges[]` y `ownership_limitations[]`

`pledges` lista las garantías registradas (`creditor`, `creditor_document_type`,
`creditor_document_number`, `registered_date`, `trust_estate`). Un vehículo
financiado muestra aquí a su acreedor (p. ej. el banco que tiene la prenda).
`ownership_limitations` lista las limitaciones a la propiedad (`limitation_type`,
`document_number`, `legal_entity`, `department`, `municipality`, `issue_date`,
`filing_date`). Ambas quedan vacías para vehículos sin gravámenes.

### `armoring`, `civil_liability[]`, certificados, `normalization[]`, `scrapping`

`armoring` reporta el estado de blindaje: `is_armored`, `level` (p. ej. `TRES`),
`level_number`, `armored_date`, `dearmored_date`, `resolution_number`,
`armoring_type`, `certificate_issue_date`, `authorization`.
`civil_liability[]` lista las pólizas de responsabilidad civil (`policy_number`,
`insurer`, `start_date`, `expiry_date`, `is_current`).
`dijin_certificate` y `scrapping_certificate` incluyen `certificate_number`,
fechas, entidad emisora y `status`. `normalization[]` reporta los registros de
normalización y `scrapping` reporta el estado de desintegración. Cada uno es
`null`/vacío cuando no aplica al vehículo.

<Note>
  Esta consulta puede tardar más que una solicitud típica. Es un
  [trabajo asíncrono](/es/async-jobs). Por defecto la solicitud espera en línea y devuelve
  `{ data }`, o puedes establecer `Prefer: wait=N`, consultar `GET /jobs/{id}` o proporcionar un
  `callback_url`.
</Note>

## Historial del vehículo por placa

`POST /co/runt/vehicle-history-by-plate/v1`

Consulta el historial de un vehículo en el RUNT solo con la placa, sin el
documento del propietario. Devuelve el o los propietarios registrados con su
número de identificación, las características del vehículo, los registros de
licencia de tránsito e importación, el historial de SOAT y técnico-mecánica, los
accidentes registrados, los trámites recientes y vigentes, y los resúmenes de
garantías y limitaciones a la propiedad.

| Campo   | Tipo   | Notas                                                                             |
| ------- | ------ | --------------------------------------------------------------------------------- |
| `plate` | string | **Obligatorio.** Placa del vehículo, p. ej. `GHW899` (carros) o `ABC12D` (motos). |

```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" }'
```

La respuesta incluye `found`, `plate`, `vehicle`, `owners[]` (cada uno con
`document_type`, `name`, `document_number`, fechas de propiedad y `owner_type`),
`traffic_license`, `import_record`, `soat_policies[]`, `inspections[]`,
`accident`, `pending_procedures[]`, `guarantee` y `limitation`. Las secciones se
entregan en la medida de lo posible: lo no disponible se devuelve vacío (`[]` o
`null`) en lugar de hacer fallar la llamada. Como la consulta anterior, es un
trabajo asíncrono.

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>