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

# RUNT Vehicle History by Plate

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

## Request

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

Look up a Colombian vehicle's history in RUNT (Registro Único Nacional de Tránsito) by plate alone, without the owner's document. Returns the registered owner(s) (name and identification number), the vehicle characteristics (brand, line, model year, class, body, color, VIN, engine/chassis/serial numbers), the traffic-license and import records, SOAT and técnico-mecánica (RTM) history, any accident on record, recent and pending procedures (trámites), and guarantee/lien and ownership-limitation summaries. `found: false` when the plate has no record.

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`.
  - `callback_url` string, uri: POST the job result here when it finishes.

## Response `200`

Successful response

- RuntVehicleHistoryResponse
  - `data` RuntVehicleHistoryData, required
    - `found` boolean, required
    - `plate` string, required
    - `vehicle` object, nullable, required
      - `plate` string, nullable, required
      - `brand` string, nullable, required
      - `line` string, nullable, required
      - `model_year` string, nullable, required
      - `body_type` string, nullable, required
      - `vehicle_class` string, nullable, required
      - `color` string, nullable, required
      - `fuel_type` string, nullable, required
      - `service_type` string, nullable, required
      - `engine_displacement` number, nullable, required
      - `vin` string, nullable, required
      - `engine_number` string, nullable, required
      - `chassis_number` string, nullable, required
      - `serial_number` string, nullable, required
      - `registration_status` string, nullable, required
      - `is_imported` boolean, nullable, required
      - `clear_of_infractions` boolean, nullable, required
      - `has_liens` boolean, nullable, required
      - `has_limitations` boolean, nullable, required
      - `is_auctioned` boolean, nullable, required
    - `owners` object[], required
      - `document_type` string, nullable, required
      - `name` string, nullable, required
      - `document_number` string, nullable, required
      - `ownership_start_date` string, nullable, required
      - `ownership_end_date` string, nullable, required
      - `owner_type` string, nullable, required
    - `traffic_license` object, nullable, required
      - `license_number` string, nullable, required
      - `traffic_authority` string, nullable, required
      - `enrollment_date` string, nullable, required
      - `license_status` string, nullable, required
    - `import_record` object, nullable, required
      - `import_record_number` string, nullable, required
      - `import_record_date` string, nullable, required
    - `soat_policies` 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
    - `inspections` object[], required
      - `inspection_type` string, nullable, required
      - `issue_date` string, nullable, required
      - `expiry_date` string, nullable, required
      - `center_name` string, nullable, required
      - `is_current` boolean, nullable, required
    - `accident` object, nullable, required
      - `accident_number` string, nullable, required
      - `accident_type` string, nullable, required
      - `accident_date` string, nullable, required
      - `injured` number, nullable, required
      - `deaths` number, nullable, required
      - `victim_condition` string, nullable, required
      - `driver` string, nullable, required
      - `area` string, nullable, required
    - `pending_procedures` object[], required
      - `request_number` string, nullable, required
      - `date` string, nullable, required
      - `status` string, nullable, required
      - `procedure` string, nullable, required
      - `entity` string, nullable, required
    - `guarantee` object, nullable, required
      - `creditor` string, nullable, required
      - `creditor_document_type` string, nullable, required
      - `creditor_document_number` string, nullable, required
      - `registered_date` string, nullable, required
      - `guarantee_type` string, nullable, required
    - `limitation` object, nullable, required
      - `limitation_type` string, nullable, required
      - `entity` string, nullable, required
      - `registered_date` string, 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)