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

Qué problema resuelve

El portal del RUNT 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 automatizar 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

• RUNTFicha 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.

¿Qué API sirve para consultar el RUNT por placa en Colombia?

PlacApi tiene un endpoint dedicado: POST /api/consulta. Recibe la placa y el tipo y número de documento del propietario actual, y responde con la ficha del vehículo tal como la publica el RUNT: informacionGeneral (marca, línea, modelo, cilindraje, servicio, clase, motor, chasis, VIN, organismo de tránsito, estado del registro y fecha de matrícula), datosTecnicos, el histórico de SOAT y de tecnomecánica con todas sus vigencias, las limitaciones a la propiedad, las garantías mobiliarias y las solicitudes de trámite. Cuesta 1 crédito por consulta con datos y responde en unos 8 segundos; reconsultar una placa que sigue en caché es casi instantáneo y no cobra.

La llamada lleva la API key en el header x-api-key, y esa misma clave y el mismo saldo sirven para el resto del catálogo: multas del SIMIT, impuesto vehicular, avalúo FASECOLDA, licencias de conducción y antecedentes de personas. El contrato se prueba en el sandbox de /integracion y se descarga como OpenAPI o como colección de Postman: integrarlo no empieza por agendar una llamada comercial.

¿Qué más del RUNT se puede consultar por API?

La ficha completa no es la única pregunta que se le hace al RUNT, y por eso PlacApi la publica en varias formas, cada una con su contrato. Una compraventa necesita saber si el carro se puede traspasar, un perito recibe el vehículo con el VIN y sin el documento del dueño, y un cotizador solo quiere marca, línea y modelo para identificar la versión: ninguno debería pagar ni leer la respuesta de los otros.

¿El RUNT tiene una API oficial para empresas?

No para el público. El RUNT intercambia información con los actores que la ley habilita —organismos de tránsito, centros de diagnóstico, aseguradoras—, pero no ofrece una API abierta para que una empresa o un desarrollador consulten la ficha de un vehículo desde su propio software. PlacApi es un servicio independiente —no es el RUNT ni la Concesión RUNT, ni tiene vínculo con ellos— que consulta el registro y entrega la respuesta normalizada en JSON, con el mismo contrato aunque el sistema oficial cambie por dentro. Reporta lo que el RUNT publica en el momento de la consulta: no expide certificados ni hace trámites.

¿Cuánto cuesta consultar el RUNT por API?

1 crédito por consulta con datos: 349 COP en el tramo de entrada y hasta 99 COP por volumen, sin mensualidad y con créditos que no vencen. Reconsultar una placa mientras sigue en caché no cobra, y si el RUNT no responde se devuelve el crédito reservado. Una placa o un documento que no coinciden tienen 10 respuestas sin resultado gratis al mes por cada tipo; después cobran igual.

¿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.

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"}'

Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/consulta.

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 el RUNT 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 de consulta vehicular completa→
• API de consulta por VIN (sin cédula)→
• 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→
• Consulta vehicular SUNARP por placa vía API→
• Récord de conductor por DNI en Perú (MTC)→
• Consulta vehicular en Chile: la ficha del vehículo por patente→
• Revisión técnica en Chile: el equivalente de la tecnomecánica→