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: Header Authorization: Bearer mw_live_•••
Format: JSON over HTTPS · TLS 1.2+

First call

Send the applicant and coverage minimums. You get back a score, tier, and explainable factors.

RequestPOST

POST https://api.markwell.ai/v1/score
Authorization: Bearer mw_live_•••
Content-Type: application/json

{
  "policy_type": "auto",
  "applicant": { "age": 34, "region": "CR-SJ", "history_years": 7 },
  "coverage":  { "amount": 8500000, "deductible": 250000 }
}

Response

{
  "score": 782,
  "tier": "low_risk",
  "factors": [
    { "name": "clean_history",   "weight": 0.34 },
    { "name": "region_low_loss", "weight": 0.21 },
    { "name": "age_band_25_40",  "weight": 0.18 }
  ],
  "latency_ms": 412
}

Available endpoints

Underwriting Scoring · score 0–1000 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