Documentation

Get started with the API in 5 minutes

We're finalizing the public docs. In the meantime, here's the baseline you need to evaluate and integrate.

Quick reference

Base URL: https://api.markwell.ai/v1
Authentication: Authorization: Bearer mw_live_••• + HMAC signature (X-Signature)
Format: JSON over HTTPS · TLS 1.2+

First call

Send the minimum policy and applicant data. You get back a score, risk level, and explainable factors.

RequestPOST

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"
}

Response

{
  "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"
}

Available endpoints

Underwriting Scoring · score 0–100 per policy with factors.
Claims Antifraud · anomaly detection on every incoming claim.
Portfolio Analytics · loss ratio and exposure, up to date.

Full reference under NDA

We activate sandbox credentials and deliver the complete reference during onboarding.

Request access