---
title: "RUNT Vehicle by Plate"
method: POST
path: "/co/runt/vehicle-by-plate/v1"
tags: ["Colombia", "RUNT"]
---

# RUNT Vehicle by Plate

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

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/runt/vehicle-by-plate/v1`
- Auth: HTTP bearer

Resolve a Colombian vehicle in RUNT (Registro Único Nacional de Tránsito) by plate and the registered owner's document. Returns the vehicle record (brand, line, model year, class, body, color, engine displacement, fuel, weights, VIN, engine/chassis/serial numbers, traffic authority, registration dates, lien/pledge flags) plus SOAT insurance history, técnico-mecánica (RTM) inspection history, extended technical data, registered guarantees/liens (with the creditor, e.g. a financing bank), ownership limitations, armoring (blindaje) status, civil-liability policies, DIJIN and scrapping certificates, normalization records, and scrapping status. `document_type` defaults to `CC`. `found: false` when the plate and owner document have no active match.

Supports async delivery: set `Prefer: wait=N` for an inline result, pass `callback_url` to receive a POST when ready, or poll `GET /jobs/{id}`.

## Headers

- `Idempotency-Key` string
- `Prefer` string

## Request body

- object
  - `plate` string, required: Colombian vehicle plate, e.g. `ABC123` or `ABC12D`.
  - `document_type` 'CC' | 'CE' | 'TI' | 'RC' | 'PA' | 'NIT' | 'PPT': Colombian document type. Defaults to `CC`.
  - `document_number` string, required: Document number (alphanumeric with hyphens allowed).
  - `callback_url` string, uri: POST the job result here when it finishes.

## Response `200`

Successful response

- RuntVehicleResponse
  - `data` RuntVehicleData, required
    - `found` boolean, required
    - `plate` string, required
    - `vehicle` object, nullable, required
      - `plate` string, nullable, required
      - `registration_status` string, nullable, required
      - `service_type` string, nullable, required
      - `vehicle_class` string, nullable, required
      - `classification` string, nullable, required
      - `body_type` string, nullable, required
      - `brand` string, nullable, required
      - `line` string, nullable, required
      - `model_year` string, nullable, required
      - `color` string, nullable, required
      - `fuel_type` string, nullable, required
      - `engine_displacement` number, nullable, required
      - `doors` number, nullable, required
      - `seated_passengers` number, nullable, required
      - `total_passengers` number, nullable, required
      - `axle_count` number, nullable, required
      - `gross_weight` number, nullable, required
      - `load_capacity` number, nullable, required
      - `vin` string, nullable, required
      - `engine_number` string, nullable, required
      - `chassis_number` string, nullable, required
      - `serial_number` string, nullable, required
      - `traffic_license_number` string, nullable, required
      - `traffic_authority` string, nullable, required
      - `country_name` string, nullable, required
      - `registration_date` string, nullable, required
      - `enrollment_date` string, nullable, required
      - `days_registered` number, nullable, required
      - `has_liens` boolean, nullable, required
      - `has_pledges` boolean, nullable, required
      - `is_repowered` boolean, nullable, required
      - `is_classic` boolean, nullable, required
      - `is_teaching_vehicle` boolean, nullable, required
      - `is_state_security` boolean, nullable, required
      - `engine_restamped` boolean, nullable, required
      - `chassis_restamped` boolean, nullable, required
      - `serial_restamped` boolean, nullable, required
      - `vin_restamped` boolean, nullable, required
    - `soat_policies` object[], required
      - `policy_number` string, nullable, required
      - `insurer` string, nullable, required
      - `is_current` boolean, nullable, required
      - `issue_date` string, nullable, required
      - `start_date` string, nullable, required
      - `expiry_date` string, nullable, required
      - `origin` string, nullable, required
      - `tariff_type` string, nullable, required
    - `inspections` object[], required
      - `certificate_number` string, nullable, required
      - `center_name` string, nullable, required
      - `inspection_type` string, nullable, required
      - `status` string, nullable, required
      - `is_current` boolean, nullable, required
      - `issue_date` string, nullable, required
      - `expiry_date` string, nullable, required
      - `plate` string, nullable, required
    - `specifications` object, nullable, required
      - `load_capacity` number, nullable, required
      - `gross_weight` number, nullable, required
      - `axle_count` number, nullable, required
      - `tire_count` number, nullable, required
      - `height` number, nullable, required
      - `width` number, nullable, required
      - `length` number, nullable, required
      - `total_passengers` number, nullable, required
      - `seated_passengers` number, nullable, required
    - `pledges` object[], required
      - `creditor` string, nullable, required
      - `creditor_document_type` string, nullable, required
      - `creditor_document_number` string, nullable, required
      - `registered_date` string, nullable, required
      - `trust_estate` string, nullable, required
    - `ownership_limitations` object[], required
      - `limitation_type` string, nullable, required
      - `document_number` string, nullable, required
      - `legal_entity` string, nullable, required
      - `department` string, nullable, required
      - `municipality` string, nullable, required
      - `issue_date` string, nullable, required
      - `filing_date` string, nullable, required
    - `armoring` object, nullable, required
      - `is_armored` boolean, nullable, required
      - `level` string, nullable, required
      - `level_number` number, nullable, required
      - `armored_date` string, nullable, required
      - `dearmored_date` string, nullable, required
      - `resolution_number` string, nullable, required
      - `armoring_type` string, nullable, required
      - `certificate_issue_date` string, nullable, required
      - `authorization` string, nullable, required
    - `civil_liability` object[], required
      - `policy_number` string, nullable, required
      - `insurer` string, nullable, required
      - `start_date` string, nullable, required
      - `expiry_date` string, nullable, required
      - `is_current` boolean, nullable, required
    - `dijin_certificate` object, nullable, required
      - `certificate_number` string, nullable, required
      - `issue_date` string, nullable, required
      - `issuing_entity` string, nullable, required
      - `status` string, nullable, required
    - `scrapping_certificate` object, nullable, required
      - `certificate_number` string, nullable, required
      - `status` string, nullable, required
      - `issue_date` string, nullable, required
      - `scrapping_entity` string, nullable, required
    - `normalization` object[], required
      - `initial_registration_deficiency` boolean, nullable, required
      - `normalized_status` string, nullable, required
      - `date` string, nullable, required
      - `administrative_act_number` string, nullable, required
    - `scrapping` object, nullable, required
      - `plate` string, nullable, required
      - `should_scrap` boolean, nullable, required

## Other responses

- `202`: Accepted — the result is being computed asynchronously. Poll `job.status_url` (GET /jobs/{id}) or supply `callback_url` to have the result POSTed to you. Returned when `Prefer: wait` elapses before completion, or immediately when `callback_url` is set.
- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)