API para consultar un vehículo por VIN en Colombia

Qué problema resuelve

La consulta por placa exige que el documento enviado sea el del propietario ACTIVO, y ese es su modo de falla dominante: en un lote real de 78.859 placas, 35.258 no se pudieron resolver porque el documento no correspondía al dueño vigente. Quien tiene el VIN —el importador, el taller, la aseguradora, el perito que lo lee del bloque del motor— no tiene por qué conocer la cédula del propietario. Este endpoint quita ese requisito.

Para quién sirve

Importadores y concesionarios que trabajan con el VIN antes de que exista la placa, talleres y peritos que lo leen del vehículo físico, aseguradoras que reciben el VIN en el reporte del siniestro, y cualquier integración que tenga el chasis pero no la cédula del dueño.

Datos requeridos

• vin — VIN del vehículo, de 11 a 17 caracteres y sin las letras I, O ni Q. Alias aceptado: chasis, porque en la mayoría de vehículos el RUNT registra el mismo valor en los dos campos.
• refresh — opcional: true salta el caché de 30 días y vuelve a consultar el registro.

Fuentes y cobertura

• RUNT — Registro Único Nacional de TránsitoLa misma consulta del portal público, indexada por VIN. Devuelve la ficha del vehículo con su histórico, no un extracto.

¿Se puede consultar un vehículo por VIN sin saber la cédula del dueño?

Sí, y es la razón de existir de este endpoint. La consulta por placa exige el documento del propietario activo; la consulta por VIN no pide documento y devuelve la misma ficha del RUNT.

¿Sirve para saber la placa de un VIN?

Sí. La respuesta trae la placa en data.plate, así que se usa como puente para encadenar después las consultas que van por placa, como multas, impuesto o avalúo.

Ejemplo de solicitud

POST https://placapi.com/api/consulta-por-vin. 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-por-vin' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"vin":"9FBXXXXXXXX123456"}'

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

Ejemplo de respuesta

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

{
  "data": {
    "plate": "ABC123",
    "documentNumber": "",
    "informacionGeneral": {
      "marca": "MAZDA",
      "linea": "CX-30",
      "modelo": 2022,
      "fechaMatricula": "14/02/2022",
      "fechaRegistro": "2022-02-14T09:31:00-05:00",
      "diasMatriculado": 1674
    }
  },
  "mode": "live",
  "fetchedAt": "2026-09-16T14:03:11.000Z"
}

Explicación campo por campo

Limitaciones y posibles errores

• Los campos fechaExpedLTImportacion, fechaVenciLTImportacion y subpartida se emiten siempre pero llegan vacíos: el registro no los publica por esta vía.
• No hay ninguna fecha anterior a la matrícula. Importación, improntas o reconocimiento previo no existen en la fuente, así que la antigüedad se cuenta desde que el vehículo quedó matriculado.
• Un VIN que el registro no reconoce responde 404 y no cobra. Los VIN de vehículos nunca matriculados en Colombia caen ahí.
• No devuelve el documento ni el nombre del propietario: este endpoint existe justamente para no tener que pedirlos.

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

Otras preguntas frecuentes

Seguir explorando

• API de consulta vehicular por placa→
• API del RUNT→
• API de avalúo FASECOLDA por código→
• API de consulta vehicular completa→
• API de pérdida total y siniestros→
• Documentación e integración→
• Documentación del endpoint POST /api/consulta-por-vin→