Endpoint: ficha de vehículo en Perú por placa

Devuelve la ficha técnica de un vehículo peruano por placa, desde el registro oficial de propiedad vehicular, con los trece campos canónicos que comparten todos los países del catálogo. En Perú el registro publica cinco de ellos y el resto llega en null, enumerados en el bloque cobertura para que el integrador sepa qué falta y por qué. No incluye datos del propietario.

POST/api/vehiculo-pe1 crédito

Ficha técnica de un vehículo peruano por placa, desde el registro oficial de propiedad vehicular. Devuelve los 13 campos canónicos comunes a todos los países; en Perú el registro publica 5 de ellos y el resto llega en `null`, listados en `cobertura.noPublicados`. Una placa fuera del registro responde `no_encontrado`. No incluye datos del propietario. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)
{
  "placa": "ABC123"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
placaobligatoriostringPlaca peruana. Se aceptan guiones (`ABC-123`).
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL
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"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/vehiculo-pe", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"placa":"ABC123"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/vehiculo-pe",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"placa":"ABC123"},
)
data = res.json()

Respuesta exitosa

200 OK — datos ficticios de ejemplo
{
  "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"
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 23 de agosto de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto