Developer Hub · REST API & SDK

Programmatic Underwriting API

Integrate instant spatial risk calculations, defensible wildfire rate modifiers, and 5-mile PML accumulation checks into your custom portal or policy admin system in minutes.

1. cURL QuickstartFastAPI REST
curl -X POST https://vesper-pricing-api-348673390035.us-central1.run.app/api/v1/actuarial/quote/wildfire   -H "Content-Type: application/json"   -H "X-API-Key: YOUR_API_KEY"   -d '{
    "policy_id": "COMM_CA_NAPA_1001",
    "location": {
      "latitude": 38.3047,
      "longitude": -122.2989
    },
    "tiv_usd": 2500000.0,
    "distance_to_brush_ft": 150.0,
    "clearance_score": 0.85
  }'
2. Python Clientpip install requests
import requests

url = "https://vesper-pricing-api-348673390035.us-central1.run.app/api/v1/actuarial/quote/wildfire"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "policy_id": "COMM_CA_NAPA_1001",
    "location": {"latitude": 38.3047, "longitude": -122.2989},
    "tiv_usd": 2500000.0,
    "distance_to_brush_ft": 150.0,
    "clearance_score": 0.85
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Production Endpoint Architecture

GET /health

Health probe reporting service availability, licensing, and current per-quote unit price ($0.15).

POST /api/v1/actuarial/quote/wildfire

Evaluates parcel topography, ERA5 live fuel dryness, and CDI buffer clearance discounts.

POST /api/v1/underwriting/validate

Executes 5-mile radius portfolio accumulation check against current book limits ($25M cap).