Illustration of a Colombia RUNT plate lookup: a pickup truck beside a panel of verified vehicle data blocks and a magnifier

Colombia RUNT Plate Lookup API (2026): Vehicle Status, SOAT, Inspection and Liens from the Plate Alone

Table of Contents
Share this article

Short answer: To run a Colombia RUNT plate lookup by API, send GET https://api.verifik.co/v2/co/runt/vehicle-by-plate-only with one parameter, plate, and your Bearer token. You don’t need the owner’s ID document. Verifik returns signed JSON with the vehicle status, SOAT insurance, technical inspection (RTM), pledges, liens, ownership limitations and RUNT requests. You can test it free in sandbox with the plate AA123BA and then pay with smartCHECK credits from $49 a month. Updated: November 2026.

Several RUNT lookups by API, including some Verifik endpoints, ask for the plate plus the owner’s document type and number. During onboarding, an insurance quote or a used-car listing, you rarely have that data. Verifik’s RUNT – Vehicle Records by Plate Only endpoint solves that: with 1 parameter (the plate) you get the vehicle’s RUNT record, including general information, technical data, SOAT policies, technical inspection, guarantees, ownership limitations and requests.

This guide covers what the lookup returns, how to call it with the official documentation example, how it differs from Verifik’s other Colombian vehicle endpoints, which business rules you can automate and how much it costs.

What the Colombia RUNT plate lookup API returns

The response contains a data object with 12 blocks of vehicle information, plus plate and vin. These are the blocks Verifik documents (field names are in Spanish, as RUNT returns them):

  • informacionGeneral: make, line, model year, color, vehicle class and body type, fuel, service type, engine displacement (the field is spelled cilidraje), doors, engine, chassis and VIN numbers, transit license, registration date, transit authority, estadoDelVehiculo (status), prendas (pledges), tieneGravamenes (liens) and repotenciado.
  • datosTecnicos: number of axles, seated passengers and gross vehicle weight.
  • soat: mandatory SOAT insurance policies with insurer, policy number, status (for example “VIGENTE”, meaning active), issue, start and expiry dates, and rate type.
  • tecnoMecanica: whether the technical-mechanical inspection is current ("vigente": "SI").
  • solicitudes: requests filed with the transit authority, with entity, status, date, request number and procedure.
  • Guarantees and limitations: garantiasMobiliarias, garantiasFavorDe, limitacionPropiedad and normalizacionSaneamiento.
  • Other blocks: polizasResponsabilidadCivil (liability policies), informacionBlindaje (armoring) and tarjetaOperacion (operating card).
  • Signature: a signature object with date and time and the message “Certified by Verifik.co”, useful as evidence for each lookup, plus a response id.

The documentation points out two details: an empty array or object means RUNT has no rows for that section, and documentType and documentNumber may be null because this endpoint doesn’t take owner data.

If the use case is clear, create an account and test the endpoint from your own code.

Why run a RUNT plate lookup by API instead of by hand in 2026

According to the official RUNT website, 22,476,551 vehicles were registered as of August 1, 2026. RUNT offers a vehicle lookup by plate so citizens can see the information the system holds about their vehicle. And the check matters: in its press bulletin 002 of 2026 (May 8, 2026), RUNT reported that more than 10 million vehicles in Colombia do not have a current technical inspection. If your operation checks dozens or thousands of plates a month, Verifik’s API gives you the vehicle record as JSON, ready for your business rules:

  • Fintech and auto-secured lending: confirm the vehicle is active and free of pledges and liens before disbursing.
  • Insurers: read make, line, model year, service type and active SOAT to quote without asking for paperwork.
  • Rental companies and fleets: track SOAT and technical inspection expiry for every vehicle. If you need to monitor those dates across a whole fleet, see our guide to the Colombia SOAT and RTM verification API.
  • Used-car marketplaces: check that the listed plate matches the make and model in the ad.

How to call the Colombia RUNT plate lookup API: endpoint, code and response

All you need is your Verifik token (Authorization: Bearer header) and 1 required parameter:

  • plate: the vehicle plate, 5 to 9 alphanumeric characters (for example AA123BA).

cURL example

curl -G "https://api.verifik.co/v2/co/runt/vehicle-by-plate-only" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $VERIFIK_TOKEN" \
  --data-urlencode "plate=AA123BA"

Node.js example

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehicle-by-plate-only", {
  params: { plate: "AA123BA" },
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
  },
});

console.log(data);

Python example

Here is the Python example from the endpoint documentation:

import os, requests

url = "https://api.verifik.co/v2/co/runt/vehicle-by-plate-only"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
response = requests.get(url, headers=headers, params={"plate": "AA123BA"})
print(response.json())

Sample response

And here is a shortened version of the sample 200 response from the documentation (we left out some informacionGeneral fields and the empty blocks):

{
  "data": {
    "informacionGeneral": {
      "claseVehiculo": "AUTOMOVIL",
      "estadoDelVehiculo": "ACTIVO",
      "fechaMatricula": "15/03/2018",
      "linea": "COROLLA",
      "marca": "TOYOTA",
      "modelo": "2020",
      "noPlaca": "AA123BA",
      "organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
      "prendas": "NO",
      "tieneGravamenes": "NO",
      "tipoServicio": "Particular"
    },
    "soat": [
      {
        "entidadExpideSoat": "SEGUROS DEL ESTADO S.A.",
        "estado": "VIGENTE",
        "fechaVencimiento": "31/12/2024",
        "noPoliza": "SOAT-000001"
      }
    ],
    "tecnoMecanica": [
      {
        "vigente": "SI"
      }
    ],
    "limitacionPropiedad": [],
    "plate": "AA123BA",
    "vin": "9FB10000001"
  },
  "signature": {
    "dateTime": "September 16, 2026 8:00 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "ABCDE"
}

Response codes to handle

CodeWhat it meansWhat to do
200Successful lookupApply your rules and store id and signature
404{"code": "NotFound", "message": "Record not found."}: the plate has no recordCheck the plate with the customer; don’t retry
409Plate missing ("missing plate") or invalidFix the parameter before resending
409 (unavailable)The service is temporarily unavailable (Endpoint_out_of_service)Retry later with backoff

Dates come back as text in day/month/year format.

Want to try it? Create your free Verifik account and, in sandbox, use the plate AA123BA or the plates ABC10001 to ABC10010, which return stable 200 responses. The plate ERR40401 returns a 404 so you can test your error handling.

Which Verifik vehicle endpoint to use in Colombia

Verifik has several RUNT endpoints by plate. The main difference is what you send and what you get back:

EndpointWhat it needsWhat it returns
/v2/co/runt/vehicle-by-plate-onlyPlate onlyVehicle record: SOAT, technical inspection, guarantees, limitations and requests
/v2/co/runt/propietariosPlate onlyBasic vehicle data and ownership records
/v2/co/runt/vehicle-by-platePlate, document type and numberComplete vehicle record with history
/v2/co/runt/vehicle-by-plate-simplifiedPlate, document type and numberEssential vehicle data, without insurance or technical inspection history

If you need to know who is listed as the owner, see our guide to the Colombia vehicle owner lookup by plate API. You can combine both endpoints: first the vehicle record, then the owners, each with the plate alone.

Colombia RUNT plate lookup for drivers, fleets and KYC onboarding

A plate lookup rarely runs alone. These are the most common flows where it’s combined with other Verifik checks:

  • Logistics and delivery: before assigning a dispatch, vet the driver (identity, licence, SIMIT and police record) and the vehicle by plate. Our Colombia driver vetting API guide shows the full 6-step flow with code.
  • Fleets and rental companies: repeat the lookup every month to catch expiries early. If you only need SOAT and RTM dates, the Colombia SOAT and RTM verification API is more direct.
  • Lending and used-car sales: confirm status and liens by plate, then who is listed as owner with the vehicle owner lookup by plate.
  • Customer onboarding: when you also need to verify the person (cédula, biometrics, police record or watchlists), the Colombia KYC API guide brings those endpoints together.

Business rules you can automate with the response

The response fields let you build simple approve-or-review rules. The diagram sums up the 6 checks and the list explains each one:

The 6 checks in a Colombia RUNT plate lookup: plate, vehicle status, pledges and liens, ownership limits, SOAT and RTM, signature

  1. Vehicle status: if estadoDelVehiculo isn’t “ACTIVO”, send the case to review.
  2. Pledges and liens: if prendas or tieneGravamenes isn’t “NO”, or garantiasMobiliarias has rows, check the debt before accepting the vehicle as collateral.
  3. Limitations: if limitacionPropiedad isn’t empty, hold the deal until you review the details.
  4. SOAT and technical inspection: compare the SOAT fechaVencimiento with today’s date and check that tecnoMecanica shows "vigente": "SI".
  5. Listing consistency: compare marca, linea, modelo and tipoServicio with what the customer declared.
  6. Evidence: store the id and signature of every response in the case file.

Here is what those rules look like in Python, including 404 and 409 handling:

import os, requests

def runt_plate_lookup(plate):
    r = requests.get(
        "https://api.verifik.co/v2/co/runt/vehicle-by-plate-only",
        headers={"Accept": "application/json",
                 "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"},
        params={"plate": plate},
        timeout=60,
    )
    if r.status_code == 404:
        return {"decision": "reject", "reason": "plate not found in RUNT"}
    if r.status_code == 409:
        return {"decision": "retry", "reason": r.json().get("message")}
    r.raise_for_status()
    d = r.json()["data"]
    g = d.get("informacionGeneral", {})
    flags = []
    if g.get("estadoDelVehiculo") != "ACTIVO":
        flags.append("vehicle not active")
    if g.get("prendas") != "NO" or g.get("tieneGravamenes") != "NO":
        flags.append("pledges or liens")
    if d.get("limitacionPropiedad"):
        flags.append("ownership limitations")
    if not any(s.get("estado") == "VIGENTE" for s in d.get("soat", [])):
        flags.append("SOAT not active")
    if not any(t.get("vigente") == "SI" for t in d.get("tecnoMecanica", [])):
        flags.append("RTM not current")
    return {"decision": "review" if flags else "approve",
            "flags": flags, "evidence": r.json().get("id")}

print(runt_plate_lookup("AA123BA"))

If RUNT shows data a customer believes is wrong, RUNT states that transit authorities are the bodies responsible for changing the registered information. Sector regulations are published by the Ministry of Transport.

For a fuller picture, add other Verifik checks: the vehicle’s full RUNT history, the simplified vehicle data check by plate, SIMIT traffic fines and vehicle insurance claims.

How much the Colombia RUNT plate lookup API costs

Verifik doesn’t charge a per-endpoint subscription: each lookup is deducted from your smartCHECK plan credits. According to the smartCHECK pricing page:

  • Starter: $49 a month, or $490 a year with $588 in credits.
  • Basic: $129 a month, or $1,290 a year with $1,548 in credits.
  • Plus: $299 a month, or $2,990 a year with $3,588 in credits.
  • Business: $649 a month, or $6,490 a year with $7,788 in credits.

Annual plans include 2 free months. The cost of each call to /v2/co/runt/vehicle-by-plate-only is deducted from your credits and shown in your dashboard once you create your account.

Start your Colombia RUNT plate lookups by API today

With the plate alone you can tell whether a vehicle is active, whether its SOAT and technical inspection are current and whether it carries pledges or limitations, with a signed record of every lookup. Read the endpoint documentation and make your first call in sandbox.

Ready to start? Create your free Verifik account or book a demo to see how to add vehicle verification to your lending, insurance or rental flow.

Miguel Treviño - Co-founder and CTO, Verifik

Frequently Asked Questions (FAQs)

➖

What is RUNT?

It is Colombia's Registro Único Nacional de Tránsito, the national transit registry. According to its official website, 22,476,551 vehicles were registered as of August 1, 2026. Verifik looks up a vehicle's RUNT record by plate.

➕

What happens if the plate has no record?

The API returns a 404 status with the message "Record not found." If the plate is missing it returns a 409 with "missing plate"; a 409 can also mean the service is temporarily unavailable.

➕

How is it different from the vehicle owner lookup?

/v2/co/runt/vehicle-by-plate-only returns the vehicle record (SOAT, technical inspection, guarantees and limitations). /v2/co/runt/propietarios returns ownership records. Both need only the plate.

➕

What does an empty block in the response mean?

According to the documentation, an empty array or object, for example limitacionPropiedad: [], means RUNT has no rows for that section of the vehicle record.

➕

Do I need a contract to get started?

No. You can create a Verifik account, test the endpoint in sandbox with the plate AA123BA and then choose a smartCHECK plan from $49 a month.

➕

What do I need to run a RUNT plate lookup by API?

A Verifik token and the plate. You send plate to the GET /v2/co/runt/vehicle-by-plate-only endpoint.

➕

Do I need the owner's ID document?

No. This endpoint only takes the plate. If you want the full history checked against a specific document, use GET /v2/co/runt/vehicle-by-plate.

➕

Does the lookup show whether SOAT is active?

Yes. The soat block returns each policy's status, insurer, and start and expiry dates.

➕

Does it show pledges or liens?

Yes. informacionGeneral includes prendas and tieneGravamenes, and the response has garantiasMobiliarias and limitacionPropiedad blocks.

➕

Can I test it without real data?

Yes. In sandbox, use AA123BA or ABC10001 to ABC10010 for 200 responses, and ERR40401 to test a 404.

➕

How often should I repeat a RUNT plate lookup?

It depends on the use case. Fleets and logistics teams should repeat it every month and before high-value trips, because SOAT and the technical inspection expire. For a loan or a used-car sale, one lookup right before approval is enough.

➕

Can I use the RUNT plate lookup to vet drivers?

It covers the vehicle. For the driver, combine it with identity, driver's licence, SIMIT fines and police record checks, as shown in Verifik's Colombia driver vetting API guide.

Explore more articles