> ## 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 um veículo colombiano no RUNT pela placa e pelo documento do proprietário registrado.
Resolve um veículo do RUNT (Registro Único Nacional de Tránsito), o registro
nacional de trânsito e veículos da Colômbia. Dada uma placa e o documento do
proprietário registrado, retorna o registro do veículo no RUNT: marca e
modelo, especificações técnicas, identificadores, autoridade de registro, datas
e indicadores de gravames e penhores.
O documento do proprietário é obrigatório: o RUNT só retorna um veículo
quando a placa e o documento correspondem a um proprietário ativo.
## Requisição
`POST /co/runt/vehicle-by-plate/v1`
| Campo | Tipo | Notas |
| ----------------- | ------ | -------------------------------------------------------------------------------------------------------- |
| `plate` | string | **Obrigatório.** Placa do veículo, p. ex. `ABC123` (carros) ou `ABC12D` (motos). |
| `document_type` | string | Opcional. Um de `CC`, `CE`, `TI`, `RC`, `PA`, `NIT`, `PPT`. Por padrão é `CC`. |
| `document_number` | string | **Obrigatório.** Número de documento do proprietário registrado (entre 3 e 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": "ABC123", "document_type": "CC", "document_number": "1234567890" }'
```
`document_type` corresponde a estes tipos de identidade: `CC` (cédula de ciudadanía), `CE`
(cédula de extranjería), `TI` (tarjeta de identidad), `RC` (registro civil), `PA`
(pasaporte), `NIT` e `PPT` (Permiso por Protección Temporal).
## Resposta
| Campo | Notas |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `found` | `true` quando a placa e o documento do proprietário têm uma correspondência ativa; `false` deixa `vehicle` em null e as listas vazias. |
| `plate` | A placa consultada (em maiúsculas). |
| `vehicle` | O registro do veículo no RUNT (ver abaixo), ou `null` quando não é encontrado. |
| `soat_policies` | Histórico de apólices de SOAT (as mais recentes primeiro). |
| `inspections` | Histórico de revisões técnico-mecânicas (RTM). |
| `specifications` | Especificações ampliadas (dimensões, pesos, capacidades), ou `null`. |
| `pledges` | Garantias registradas (garantias/penhores), incluído o credor (p. ex. um banco que financia). |
| `ownership_limitations` | Limitações à propriedade. |
| `armoring` | Estado e nível de blindagem, ou `null` quando não é blindado. |
| `civil_liability` | Apólices de responsabilidade civil. |
| `dijin_certificate` | Certificado DIJIN, ou `null` quando não há registro. |
| `scrapping_certificate` | Certificado de desintegração, ou `null`. |
| `normalization` | Registros de normalização. |
| `scrapping` | Estado de desintegração, ou `null`. |
Todas as seções além de `vehicle` são entregues na medida do possível:
se uma seção não está disponível para um determinado veículo, ela é retornada
vazia (`[]` ou `null`) em vez de fazer a chamada falhar.
### `vehicle`
| Campo | Notas |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `plate` | A placa do veículo. |
| `registration_status` | Estado do registro, p. ex. `ACTIVO`. |
| `service_type` | Tipo de serviço, p. ex. `Particular` / `Público`. |
| `vehicle_class`, `classification`, `body_type` | Classe (p. ex. `AUTOMOVIL`), classificação e tipo de carroceria. |
| `brand`, `line`, `model_year`, `color` | Marca, linha, ano do modelo e cor. |
| `fuel_type`, `engine_displacement` | Tipo de combustível e cilindrada do motor (cc). |
| `doors`, `seated_passengers`, `total_passengers` | Portas e capacidade de passageiros. |
| `axle_count`, `gross_weight`, `load_capacity` | Eixos, peso bruto e capacidade de carga. |
| `vin`, `engine_number`, `chassis_number`, `serial_number` | Identificadores do veículo. |
| `traffic_license_number` | Número da licença de trânsito. |
| `traffic_authority` | Organismo de trânsito que realizou o registro. |
| `country_name` | País de origem, quando aplicável. |
| `registration_date`, `enrollment_date`, `days_registered` | Datas de registro e dias registrado. |
| `has_liens`, `has_pledges` | Se o veículo tem gravames ou penhores registrados. |
| `is_repowered`, `is_classic`, `is_teaching_vehicle`, `is_state_security` | Indicadores de estado. |
| `engine_restamped`, `chassis_restamped`, `serial_restamped`, `vin_restamped` | Se cada identificador foi regravado. |
Os indicadores `SI`/`NO` são retornados como booleanos, os campos numéricos como
números e as datas como `yyyy-mm-dd`. Os valores ausentes são `null`.
### `soat_policies[]`
Cada apólice de SOAT inclui `policy_number`, `insurer`, `is_current` (a
apólice atualmente vigente), `issue_date`, `start_date`, `expiry_date`, `origin` e
`tariff_type`.
### `inspections[]`
Cada registro de técnico-mecânica (RTM) inclui `certificate_number`, `center_name`
(o CDA), `inspection_type`, `status`, `is_current`, `issue_date`, `expiry_date`
e `plate`.
### `specifications`
`load_capacity`, `gross_weight`, `axle_count`, `tire_count`, `height`, `width`,
`length`, `total_passengers`, `seated_passengers`.
### `pledges[]` e `ownership_limitations[]`
`pledges` lista as garantias registradas (`creditor`, `creditor_document_type`,
`creditor_document_number`, `registered_date`, `trust_estate`). Um veículo
financiado mostra aqui seu credor (p. ex. o banco que detém o penhor).
`ownership_limitations` lista as limitações à propriedade (`limitation_type`,
`document_number`, `legal_entity`, `department`, `municipality`, `issue_date`,
`filing_date`). Ambas ficam vazias para veículos sem gravames.
### `armoring`, `civil_liability[]`, certificados, `normalization[]`, `scrapping`
`armoring` reporta o estado de blindagem: `is_armored`, `level` (p. ex. `TRES`),
`level_number`, `armored_date`, `dearmored_date`, `resolution_number`,
`armoring_type`, `certificate_issue_date`, `authorization`.
`civil_liability[]` lista as apólices de responsabilidade civil (`policy_number`,
`insurer`, `start_date`, `expiry_date`, `is_current`).
`dijin_certificate` e `scrapping_certificate` incluem `certificate_number`,
datas, entidade emissora e `status`. `normalization[]` reporta os registros de
normalização e `scrapping` reporta o estado de desintegração. Cada um é
`null`/vazio quando não se aplica ao veículo.
Esta consulta pode demorar mais do que uma requisição típica. É um
[trabalho assíncrono](/pt/async-jobs). Por padrão a requisição aguarda de forma síncrona e retorna
`{ data }`, ou você pode definir `Prefer: wait=N`, consultar `GET /jobs/{id}` ou fornecer um
`callback_url`.
## Histórico do veículo por placa
`POST /co/runt/vehicle-history-by-plate/v1`
Consulta o histórico de um veículo no RUNT apenas com a placa, sem o
documento do proprietário. Retorna o proprietário ou proprietários registrados
com seu número de identificação, as características do veículo, os registros de
licença de trânsito e importação, o histórico de SOAT e técnico-mecânica, os
acidentes registrados, os trâmites recentes e vigentes, e os resumos de
garantias e limitações à propriedade.
| Campo | Tipo | Notas |
| ------- | ------ | -------------------------------------------------------------------------------- |
| `plate` | string | **Obrigatório.** Placa do veículo, p. ex. `ABC123` (carros) ou `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": "ABC123" }'
```
A resposta inclui `found`, `plate`, `vehicle`, `owners[]` (cada um com
`document_type`, `name`, `document_number`, datas de propriedade e `owner_type`),
`traffic_license`, `import_record`, `soat_policies[]`, `inspections[]`,
`accident`, `pending_procedures[]`, `guarantee` e `limitation`. As seções são
entregues na medida do possível: o que não está disponível é retornado vazio
(`[]` ou `null`) em vez de fazer a chamada falhar. Como a consulta anterior, é
um trabalho assíncrono.
Esquemas, campos de resposta e um playground interativo.