Documentación

Empieza con la API en 5 minutos

Estamos finalizando la documentación pública. Mientras tanto, aquí está lo básico para evaluar e integrar.

Referencia rápida

Base URL: https://api.markwell.ai/v1
Autenticación: Authorization: Bearer mw_live_••• + firma HMAC (X-Signature)
Formato: JSON sobre HTTPS · TLS 1.2+

Primera llamada

Envía los datos mínimos de la póliza y el solicitante. Recibes score, nivel de riesgo y factores explicables.

SolicitudPOST

POST https://api.markwell.ai/v1/score
Authorization: Bearer mw_live_•••
X-Signature: t=1716070000, v1=a8b9c…
Content-Type: application/json

{
  "ramo": "riesgos_trabajo",
  "actividad_ciiu": "4520",
  "provincia": "Puntarenas",
  "edad": 38,
  "num_empleados": 45,
  "suma_asegurada": 15000000,
  "siniestros_previos": 1,
  "antiguedad_cliente": 2,
  "canal": "agente"
}

Respuesta

{
  "score": 97,
  "nivel_riesgo": "ALTO",
  "prima_sugerida": 215000,
  "factores": [
    { "label": "Actividad CIIU de alto riesgo laboral", "impacto": "alto" },
    { "label": "Puntarenas — zona de riesgo elevado", "impacto": "alto" },
    { "label": "1 siniestro previo registrado", "impacto": "medio" }
  ],
  "alerta_fraude": false,
  "probabilidad": 0.9722,
  "modelo_version": "2.1.0",
  "roc_auc_modelo": 0.8483,
  "tenant": "Markwell Demo",
  "request_id": "mw_demo_fixed_1778975358.522399"
}

Endpoints disponibles

Underwriting Scoring · score 0–100 por póliza con factores.
Claims Antifraud · detección de anomalías sobre cada siniestro.
Portfolio Analytics · loss ratio y exposición al día.

Documentación completa bajo NDA

Activamos credenciales sandbox y entregamos la referencia completa durante el onboarding.

Solicitar acceso