API RUNT Colombia: consulta la ficha del vehículo por placa vía REST

Qué problema resuelve

El portal del RUNT (runt.gov.co) exige captcha y no ofrece una API pública para desarrolladores. Integrar la ficha de un vehículo en un CRM, un flujo de compraventa o un score de crédito obliga a scrapear un sitio inestable. PlacApi encapsula esa consulta en un único endpoint REST estable que devuelve la ficha del RUNT normalizada en JSON.

Para quién sirve

Concesionarios, plataformas de usados, talleres, aseguradoras y fintechs que necesiten la ficha técnica y el estado del RUNT de un vehículo colombiano dentro de su propio software.

Datos requeridos

• placa — placa del vehículo.
• docType — tipo de documento del propietario (CC, CE, NIT…).
• docNumber — número de documento del propietario actual, exigido por el RUNT.

Fuentes y cobertura

• RUNT (runt.gov.co)Ficha del vehículo: marca, línea, modelo, cilindraje, combustible, servicio, clase, motor, chasis, VIN, organismo de tránsito y estado del registro.
• SOAT y tecnomecánica vía RUNTEl RUNT reporta el histórico de pólizas SOAT y de revisiones tecnomecánicas (RTM), que se devuelven como arrays dentro de la misma ficha.

¿Cómo consultar el RUNT por API en Colombia?

Con una llamada POST a /api/consulta enviando la placa y el documento del propietario. La respuesta llega en JSON con la ficha del vehículo —marca, línea, modelo, cilindraje, motor, chasis, estado del registro— y el histórico de SOAT y tecnomecánica dentro del mismo objeto. No hay captcha ni navegador de por medio: es una API REST y se integra desde cualquier backend en minutos.

¿Necesito el documento del dueño para consultar el RUNT?

Sí. Es una medida de privacidad del Estado: se requiere placa + número de documento del propietario actual.

Ejemplo de solicitud

POST https://placapi.com/api/consulta. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

curl -X POST 'https://placapi.com/api/consulta' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123","docType":"CC","docNumber":"1020304050"}'

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

{
  "data": {
    "documentNumber": "1020304050",
    "plate": "ABC123",
    "vin": "9FB10000001",
    "informacionGeneral": {
      "noPlaca": "ABC123",
      "marca": "MAZDA",
      "linea": "CX-30",
      "modelo": "2023",
      "cilindraje": "2000",
      "color": "ROJO",
      "claseVehiculo": "CAMIONETA",
      "tipoServicio": "Particular",
      "tipoCombustible": "GASOLINA",
      "noMotor": "MTR0000001",
      "noChasis": "9FB10000001",
      "noVin": "9FB10000001",
      "fechaMatricula": "15/03/2023",
      "organismoTransito": "SEC. MOVILIDAD BOGOTA",
      "estadoDelVehiculo": "ACTIVO",
      "tieneGravamenes": "NO",
      "prendas": "NO"
    },
    "datosTecnicos": {
      "pesoBrutoVehicular": "1650",
      "noEjes": "2",
      "pasajerosSentados": "5"
    },
    "soat": [
      {
        "entidadExpideSoat": "SBS SEGUROS",
        "estado": "VIGENTE",
        "noPoliza": "40001234567",
        "fechaVigencia": "20/09/2025",
        "fechaVencimiento": "19/09/2026"
      }
    ],
    "tecnoMecanica": [
      {
        "cdaExpide": "CDA FONTIBON",
        "estado": "APROBADA",
        "vigente": "SI",
        "fechaVencimiento": "22/09/2026",
        "nroCertificado": "20250012345",
        "url": "20250012345"
      }
    ],
    "polizasResponsabilidadCivil": [],
    "tarjetaOperacion": null,
    "informacionBlindaje": null,
    "solicitudes": [],
    "garantiasMobiliarias": [],
    "garantiasFavorDe": [],
    "limitacionPropiedad": [],
    "normalizacionSaneamiento": []
  },
  "mode": "live",
  "fetchedAt": "2026-07-11T21:00:00.000Z"
}

Explicación campo por campo

Limitaciones y posibles errores

• Sin el documento del propietario actual el RUNT no devuelve la ficha del vehículo.
• Si runt.gov.co está en mantenimiento, la consulta puede fallar o devolver campos vacíos.
• Las multas SIMIT, el impuesto vehicular, el avalúo FASECOLDA y el pico y placa no vienen en esta ficha: cada uno tiene su propio endpoint dedicado.
• PlacApi no es el RUNT ni una entidad oficial; solo consolida y normaliza lo que el RUNT expone.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

Seguir explorando

• API FASECOLDA: valor comercial por placa→
• API de consulta vehicular (ficha RUNT)→
• API SOAT (histórico dentro de la ficha)→
• API tecnomecánica (RTM)→
• API de multas SIMIT→
• Documentación del endpoint→
• Precios por consulta→
• API de bienes y rentas→
• API de antecedentes fiscales→
• Barrer miles de placas: concurrencia y costo→
• API de prendas y embargos por placa→
• API de traspaso: si un carro se puede traspasar→