Consulta vehicular SUNARP por placa: la ficha del vehículo peruano vía API REST

Qué problema resuelve

La consulta vehicular peruana vive en un portal web con captcha que entrega la ficha como una imagen renderizada, no como texto: no hay JSON, no hay API pública y no hay nada que un backend pueda leer directo. Quien necesita verificar un vehículo peruano desde su sistema —una compraventa, una aseguradora, un marketplace, una flota— termina copiando datos a mano o manteniendo una automatización con reconocimiento óptico que se rompe cada vez que el portal cambia de plantilla. PlacApi hace ese recorrido completo, lectura de la imagen incluida, y entrega un JSON estable con el mismo contrato que el resto del catálogo.

Para quién sirve

Plataformas de compraventa de usados y marketplaces con inventario peruano, aseguradoras y corredores que suscriben en Perú, operadores de flota y de leasing con vehículos matriculados allá, empresas de rastreo satelital que dan de alta unidades, y equipos de producto colombianos que ya integraron PlacApi y quieren cubrir Perú sin escribir un segundo cliente.

Datos requeridos

• placa — la placa peruana del vehículo. Se aceptan guiones: ABC-123 y ABC123 son la misma consulta.
• refresh — opcional: salta la caché de 30 días y vuelve a preguntarle al registro. Una consulta refrescada con datos cobra.

Fuentes y cobertura

• SUNARP — Registro de Propiedad VehicularFicha del vehículo por placa: marca, modelo (la línea), color, año de fabricación y número de serie o VIN. Es el registro donde se inscribe la propiedad vehicular en Perú y la misma ficha que devuelve su consulta pública, con la diferencia de que allí llega como imagen y aquí como JSON.

¿Por qué llegan 5 campos de 13 y por qué eso no es un error?

PlacApi usa un contrato único de trece campos canónicos para la ficha de vehículo de todos los países: clase, tipo, carrocería, marca, línea, capacidad de pasajeros, capacidad de carga, color, modelo, servicio público, VIN, combustible y cilindraje. El contrato no cambia según el país; lo que cambia es cuántos de esos campos publica cada registro. En Perú son cinco: marca, línea, color, año del modelo y VIN. Los otros ocho llegan en null.

La razón es física, no de diseño. La consulta vehicular peruana no devuelve un formulario de datos sino una ficha renderizada como imagen, y de esa imagen se puede leer lo que está impreso, ni un campo más. El registro simplemente no imprime el cilindraje ni la capacidad de carga en esa vista. Nosotros preferimos decirlo a inventarlo: un cilindraje deducido de la línea sería un número plausible y falso, y un integrador que lo use para calcular una prima o un impuesto no tiene forma de saber que se lo inventamos.

Por eso cada respuesta trae un bloque cobertura con dos listas: disponibles, los campos que el registro sí publicó para esa placa, y noPublicados, los que no. Es la instrucción de integración más útil de toda la respuesta, porque convierte una decisión de producto en una condición que se puede programar: si el campo está en noPublicados, tu interfaz debe ocultarlo o pedirlo por otra vía, no mostrar un guion y dejar al usuario pensando que el dato se perdió.

El mismo parser para Colombia y Perú: qué cambia y qué no

El sobre de la respuesta es el mismo del resto del catálogo —source, status, data, mode, fetchedAt— y dentro de data el primer campo es pais, con el código ISO del país que respondió. Un cliente que ya lee la ficha colombiana solo tiene que aceptar nulls donde antes siempre había valor; no hay un segundo esquema, ni un segundo SDK, ni un segundo formato de fechas.

La diferencia de entrada sí es real y conviene tenerla presente al diseñar el formulario: la consulta colombiana exige placa más el documento del propietario, porque el RUNT no responde sin esa pareja. La peruana va con la placa sola. Eso simplifica el flujo —no hay que pedirle al usuario un dato que muchas veces no tiene— y también significa que esta consulta no verifica titularidad: responde por el vehículo, no por quién lo tiene.

El costo es idéntico en los dos países, 1 crédito por consulta con datos, y se comparte el mismo saldo, la misma API key y el mismo panel de consumos. No hay un plan aparte para internacional ni un mínimo distinto por país.

Qué no devuelve esta consulta: propietario, papeletas y revisión técnica

Esta es una ficha técnica del vehículo. No trae el nombre del propietario, ni el historial de transferencias, ni gravámenes, ni si el vehículo está reportado. Es una decisión deliberada y también la del propio registro en su consulta pública: los datos personales del titular no viajan en esta respuesta.

Las deudas y los documentos del vehículo viven en registros distintos y por eso son endpoints distintos, cada uno con su crédito: las papeletas de tránsito pendientes están en /api/multas-pe, que une el récord nacional de carreteras con el de Lima Metropolitana, y los certificados de inspección técnica en /api/revision-tecnica-pe. Si tu flujo es «verificar un usado antes de comprarlo», las tres consultas son complementarias y ninguna reemplaza a las otras dos.

¿Cómo consultar un vehículo peruano por placa desde una API?

Con una llamada POST a /api/vehiculo-pe enviando la placa en el cuerpo, y la API key en el header x-api-key. La respuesta llega en JSON con marca, línea, año, color y VIN, y con un bloque cobertura que enumera qué campos publica el registro y cuáles no. No hace falta el documento del propietario: en Perú la consulta va con la placa sola.

¿Por qué muchos campos de la ficha peruana llegan en null?

Porque el Registro de Propiedad Vehicular publica cinco de los trece campos del contrato canónico y el resto no los imprime en la ficha que entrega. Preferimos declararlo en cobertura.noPublicados antes que deducir un cilindraje o una carrocería a partir de la línea: un dato deducido se ve igual que uno real y quien lo recibe no tiene cómo distinguirlos.

Ejemplo de solicitud

POST https://placapi.com/api/vehiculo-pe. 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-pe' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123"}'

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": {
    "pais": "PE",
    "placa": "ABC123",
    "clase": null,
    "tipo": null,
    "carroceria": null,
    "marca": "SUZUKI",
    "linea": "GRAND NOMADE",
    "capacidadPasajeros": null,
    "capacidadCargaKg": null,
    "color": "GRIS",
    "modelo": 2010,
    "servicioPublico": null,
    "vin": "JS3TE04V2A4602091",
    "combustible": null,
    "cilindraje": null
  },
  "cobertura": {
    "disponibles": [
      "marca",
      "linea",
      "color",
      "modelo",
      "vin"
    ],
    "noPublicados": [
      "clase",
      "tipo",
      "carroceria",
      "capacidadPasajeros",
      "capacidadCargaKg",
      "servicioPublico",
      "combustible",
      "cilindraje"
    ]
  },
  "portalUrl": "https://consultavehicular.sunarp.gob.pe/consulta-vehicular/inicio",
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z"
}

Explicación campo por campo

Limitaciones y posibles errores

• El registro publica 5 de los 13 campos canónicos. Clase, tipo, carrocería, capacidad de pasajeros, capacidad de carga, servicio público, combustible y cilindraje llegan en null y quedan enumerados en cobertura.noPublicados. No es un fallo de la consulta: es lo que la fuente imprime.
• La ficha oficial se entrega como imagen renderizada y se lee por reconocimiento óptico. Cuando el VIN es crítico —un traspaso, una póliza, un alta de flota— conviene contrastarlo contra la tarjeta de propiedad antes de escribirlo en un contrato.
• No devuelve datos del propietario, ni historial de transferencias, ni gravámenes. Responde por el vehículo, no por su titularidad.
• Una placa fuera del registro responde 404 con el código no_encontrado y NO cobra crédito. Es un 404 y no un 502 a propósito: el registro sí contestó, y contestó que no la tiene, así que reintentar no va a cambiar la respuesta.
• No incluye papeletas ni revisión técnica: viven en registros distintos y son endpoints distintos, cada uno con su crédito.

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

Otras preguntas frecuentes

Seguir explorando

• Revisión técnica por placa (CITV) en Perú→
• Papeletas por placa en Perú vía API→
• Récord de conductor por documento en Perú→
• API de consulta vehicular Colombia: la ficha del RUNT→
• Referencia del endpoint POST /api/vehiculo-pe→
• Todos los endpoints de Perú→