Endpoint SOAT

Consulta el SOAT vigente de un vehículo a partir de su placa. Los datos provienen del registro nacional de APESEG (Asociación Peruana de Empresas de Seguros).

URL

GET /api/soat?placa=ABC123

Parámetros

Parámetro Tipo Descripción
placa string (requerido) 6 o 7 caracteres alfanuméricos. Acepta guiones y minúsculas (se normaliza). También se acepta el alias numero.

Fuente

Los datos provienen del consultor SOAT de APESEG, que consolida las pólizas emitidas por todas las aseguradoras del país. Si la placa registra varias pólizas, la API devuelve la más reciente.

Ejemplo de request

curl -X GET "https://apisperu.gsalinas.site/api/soat?placa=F5U597" \
  -H "Authorization: Bearer apk_demo_apisperu_pub_2BfHK7nN4tV9X8jE3LpQ5sUcZ"

Ejemplo de response

{
  "ok": true,
  "data": {
    "placa": "F5U597",
    "aseguradora": "Mapfre Perú",
    "numeroPoliza": "000000000003022500223435",
    "inicioVigencia": "27/06/2025",
    "finVigencia": "27/06/2026",
    "estado": "VIGENTE",
    "tipoUso": "PARTICULAR",
    "clase": "AUTOMOVIL",
    "tipoCertificado": "DIGITAL",
    "fuente": "apeseg"
  }
}

Campos del response

Campo Tipo Descripción
placa string Placa consultada (normalizada en mayúsculas, sin guiones).
aseguradora string Compañía de seguros que emitió el SOAT.
numeroPoliza string Número de póliza del certificado.
inicioVigencia string Fecha de inicio de vigencia (DD/MM/YYYY).
finVigencia string Fecha de fin de vigencia (DD/MM/YYYY).
estado string Estado del SOAT (VIGENTE, VENCIDO, ANULADO).
tipoUso string Uso del vehículo (PARTICULAR, CARGA, etc.).
clase string Clase del vehículo (AUTOMOVIL, CAMIONETA, etc.).
tipoCertificado string Tipo de certificado (DIGITAL, FISICO).
fuente string Proveedor de origen (apeseg).

Errores específicos

Probar en el playground