APIs de consulta vehicular y de conductores en Perú

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.

Certificados de inspección técnica vehicular (CITV) de un vehículo peruano por placa: el equivalente a la tecnomecánica. Devuelve si hay un certificado vigente y hasta cuándo, y los tres certificados más recientes (es lo que publica el registro) con número, vigencia, resultado, estado, centro de inspección, tipo de servicio y observaciones. status es ok con certificado vigente, warn si solo hay historial vencido e info sin certificados. Una placa sin certificados es una respuesta válida (certificados vacío, vigente: false) y cobra. Cuesta 1 crédito.

SOAT (seguro obligatorio de accidentes de tránsito) de un vehículo peruano por placa, desde el registro central de las aseguradoras. Devuelve si hay una póliza vigente y hasta cuándo, la aseguradora que la emitió, y el histórico de pólizas (del más reciente al más viejo) con estado, vigencia (inicio y fin), número de póliza, código único, código SBS de la aseguradora, uso y clase del vehículo, marca, modelo, número de asientos y tipo de certificado. status es ok con póliza vigente, warn si solo hay historial vencido e info sin pólizas. Una placa sin SOAT registrado es una respuesta válida (certificados vacío, vigente: false) y cobra. No incluye datos del asegurado. Cuesta 1 crédito.

Papeletas de tránsito PENDIENTES de un vehículo peruano por placa, unidas de tres registros: el récord nacional de infracciones en carreteras (origen: "nacional"), las papeletas de Lima Metropolitana (origen: "lima") y las de la Provincia Constitucional del Callao (origen: "callao"). Devuelve el total, las pendientes, el monto pendiente en soles y cada papeleta con número, fecha, código y descripción de la infracción, gravedad, monto, estado y entidad. monto es la deuda viva: en Lima, importe + costas − descuento; en el Callao, el importe insoluto. El registro nacional no publica montos, así que ahí llega null y montoPendiente suma solo las que lo traen. descripcion es el texto de la infracción según el Reglamento Nacional de Tránsito y llega null cuando el código pertenece a otro reglamento; tipoRegistro es el rótulo con que el registro nacional clasifica el documento y nunca describe la infracción. Las pagadas no aparecen. El bloque cobertura dice cómo respondió cada registro (ok, sin_datos, error): si uno falla, los otros igual se entregan. status es warn con pendientes y ok sin ellas. Una placa sin papeletas es una respuesta válida y cobra. Cuesta 1 crédito.

Récord del conductor peruano por documento: licencias de conducir con número, clase y categoría, estado (VIGENTE o compuestos como CANCELADA/CONDUCTOR INHABILITADO), fechas de expedición y revalidación y restricciones, más las sanciones (resolución, fechas de inicio y fin, y estado derivado de esas fechas). No devuelve nombre ni datos de la persona: solo lo que describe la licencia. puntos llega siempre null: el registro no los publica. status es ok con licencia vigente, warn con cualquier otro estado o sanción vigente e info sin licencia. Un documento sin licencia es una respuesta válida (tieneLicencia: false) y cobra; un DNI que no tenga exactamente 8 dígitos responde 400 consulta_invalida sin cobrar. Cuesta 1 crédito.