Premium estimate (pure-premium method) API

Estimate the gross premium with the canonical pure-premium pricing identity: gross = (claim frequency × severity) ÷ (1 − expense load − profit load), scaled by exposure units, with a per-component breakdown. Deterministic actuarial pricing. Answers 'estimate the insurance premium', 'pure premium pricing', 'gross up premium for expenses', 'rate per exposure unit'.

Price$0.01per request

MethodPOST

Route/v1/calc/ins-premium-estimate

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcinsurancepremiumpricingpure-premiumactuarialratemakingloading

API URLhttps://x402.hexl.dev/v1/calc/ins-premium-estimate

Integration docs

Example request

{
  "claimFrequency": 0.05,
  "claimSeverity": 8000,
  "expenseLoad": 0.25,
  "profitLoad": 0.05
}

Example response

{
  "method": "pure-premium pricing",
  "purePremium": 400,
  "loadFactor": 0.3,
  "grossPremiumPerUnit": 571.43,
  "totalGrossPremium": 571.43,
  "exposureUnits": 1,
  "breakdown": [
    {
      "component": "pure premium (freq×severity)",
      "value": 400
    },
    {
      "component": "expense load",
      "value": 0.25
    },
    {
      "component": "profit load",
      "value": 0.05
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [],
  "properties": {
    "claimFrequency": {
      "type": "number",
      "examples": [
        0.05
      ],
      "description": "claims per exposure"
    },
    "claimSeverity": {
      "type": "number",
      "examples": [
        8000
      ],
      "description": "avg claim (USD)"
    },
    "pureP": {
      "type": "number",
      "examples": [
        400
      ],
      "description": "pure premium directly (overrides freq×severity)"
    },
    "expenseLoad": {
      "type": "number",
      "examples": [
        0.25
      ],
      "description": "default 0.25"
    },
    "profitLoad": {
      "type": "number",
      "examples": [
        0.05
      ],
      "description": "default 0.05"
    },
    "exposureUnits": {
      "type": "number",
      "examples": [
        1
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}