API para consultar un vehículo en Colombia solo con la placa, sin la cédula del propietario

Qué problema resuelve

La consulta vehicular por placa con documento exige que el documento sea el del propietario ACTIVO, y ese es su modo de falla dominante: 1 de cada 6 consultas vuelve sin datos porque la cédula enviada es la del dueño anterior, la del comprador o la del conductor. Una flota que recibe vehículos de terceros, un marketplace que publica un usado o una aseguradora que cotiza tienen la placa, pero casi nunca la cédula correcta del dueño. Lo que necesitan —qué vehículo es y si tiene el SOAT y la tecnomecánica al día— no depende de quién es el dueño.

Para quién sirve

Plataformas de transporte y logística que vinculan conductores con vehículo propio (el conductor rara vez es el propietario), flotas y empresas de renting que controlan vencimientos de vehículos de contratistas, marketplaces y compraventas de usados que validan un aviso, aseguradoras y corredores que cotizan con la placa, talleres, parqueaderos y apps de movilidad.

Datos requeridos

• placa — la placa del vehículo, de 5 a 7 caracteres; los guiones y espacios se ignoran. Es el único dato obligatorio.
• refresh — opcional: true salta el caché y vuelve a consultar el registro.

Fuentes y cobertura

• RUNT — Registro Único Nacional de TránsitoFicha del vehículo, pólizas SOAT y revisiones técnico-mecánicas registradas. El dato es el del día de la consulta, no una copia de otra base.

Qué sale con la placa sola y qué exige el documento

La placa sola alcanza para saber qué vehículo es y si está al día con el SOAT y la tecnomecánica. Lo que depende de la persona —quién es el dueño, qué gravámenes pesan sobre la propiedad— sigue exigiendo el documento del propietario actual, y para eso está `/api/consulta`.

Ficha completa o resumen: cómo leer `cobertura`

Casi siempre la respuesta trae la ficha completa. Cuando el vehículo no tiene con qué pedirla —ni VIN ni ninguna revisión técnico-mecánica registrada, el caso de algunos modelos anteriores a 2011— o esa parte del registro no responde en el momento, sale el resumen: la misma ficha sin fecha de matrícula, ejes, pasajeros, peso ni puertas, y el SOAT y la tecnomecánica con sus 3 registros más recientes. La respuesta lo dice en cobertura y explica la causa en advertencia, así que la integración nunca tiene que adivinar.

Vigencia calculada, también para vehículos nuevos

soat.vigente y tecnomecanica.vigente llegan como booleanos, no como fechas para comparar del lado del cliente. Un vehículo nuevo que todavía está dentro del plazo de su primera revisión (artículo 52 de la Ley 769 de 2002: 5 años desde la matrícula el particular distinto de moto, 2 el público y las motos) sale con tecnomecanica.exento: true y vigente: true, en vez de aparecer como «sin tecnomecánica». status resume las dos: ok con ambas al día, danger si alguna venció.

¿Cuánto cuesta consultar un vehículo por placa sin cédula?

10 créditos por consulta con datos. Cada crédito vale 349 COP en el tramo de entrada y baja hasta 99 COP por volumen, así que la consulta va de 3.490 a 990 COP, sin mensualidad y con créditos que no vencen. Una respuesta de caché, un 502 o un sin-resultado dentro de la cortesía mensual no cobran.

¿Se puede consultar el SOAT y la tecnomecánica solo con la placa?

Sí, por API. POST /api/vehiculo-placa recibe solo la placa y devuelve el SOAT y la revisión técnico-mecánica con vigente ya calculado, junto con la ficha técnica del vehículo. No pide el documento del propietario.

Ejemplo de solicitud

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

curl -X POST 'https://placapi.com/api/vehiculo-placa' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123"}'

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

Ejemplo de respuesta

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

{
  "source": "vehiculo",
  "status": "ok",
  "data": {
    "placa": "ABC123",
    "marca": "MAZDA",
    "linea": "CX-30",
    "modelo": "2023",
    "clase": "CAMIONETA",
    "servicio": "PARTICULAR",
    "vin": "3MVDM2W7XPL123456",
    "fechaMatricula": "15/03/2023",
    "soat": {
      "vigente": true,
      "fechaVencimiento": "15/03/2027",
      "entidad": "SEGUROS DEL ESTADO S.A."
    },
    "tecnomecanica": {
      "vigente": true,
      "exento": true,
      "fechaPrimeraRevision": "15/03/2028"
    }
  },
  "cobertura": {
    "ficha": "completa",
    "soat": "completa",
    "tecnomecanica": "completa"
  },
  "mode": "live",
  "fetchedAt": "2026-11-05T15:20:00.000Z"
}

Explicación campo por campo

Limitaciones y posibles errores

• No devuelve el propietario, ni prendas, embargos o limitaciones a la propiedad: esos datos dependen del documento del dueño y salen en /api/consulta.
• Cuesta 10 créditos por consulta con datos, no 1. Si ya tienes el documento correcto del propietario, /api/consulta trae más por menos.
• Una placa que el registro no tiene responde 404 vehiculo_no_registrado y cuesta 1 crédito, solo después de las 10 respuestas sin resultado gratis de cada mes.
• Si el registro no responde, la respuesta es 502 source_error: no cobra y se puede reintentar.

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

Otras preguntas frecuentes

Seguir explorando

• API de consulta vehicular con documento→
• API del SOAT→
• API de tecnomecánica→
• API de consulta por VIN→
• API de consulta masiva de placas→
• Documentación e integración→
• Documentación del endpoint POST /api/vehiculo-placa→