{
  "tool": "msc-risk--actuarial.buhlmann_credibility",
  "name": "Bühlmann credibility premium (CDU-BUS-RSK-900)",
  "answers": "How much weight should this risk’s own experience get against the collective, and what premium results?",
  "degree": {
    "id": "competency:msc-risk--actuarial",
    "code": "CDU-BUS-RSK-900",
    "name": "MSc Risk & Actuarial",
    "version": "1.0.0"
  },
  "reference": "Bühlmann, H. (1967) Experience rating and credibility, ASTIN Bulletin 4(3); IFoA CS2 — the Bühlmann model",
  "endpoint": "/faculty/msc-risk--actuarial/buhlmann_credibility",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "observations",
      "sampleMean",
      "collectiveMean",
      "expectedProcessVariance",
      "varianceOfHypotheticalMeans"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "observations": {
        "type": "number",
        "description": "Number of periods (or exposures) of own experience",
        "minimum": 1
      },
      "sampleMean": {
        "type": "number",
        "description": "Mean claims of this risk",
        "minimum": 0
      },
      "collectiveMean": {
        "type": "number",
        "description": "Mean claims of the collective (μ)",
        "minimum": 0
      },
      "expectedProcessVariance": {
        "type": "number",
        "description": "EPV: expected variance within a risk",
        "minimum": 0
      },
      "varianceOfHypotheticalMeans": {
        "type": "number",
        "description": "VHM: variance of risk means across the collective",
        "minimum": 0.000001
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "k",
      "credibilityFactor",
      "credibilityPremium"
    ],
    "properties": {
      "k": {
        "type": "number",
        "description": "EPV ÷ VHM"
      },
      "credibilityFactor": {
        "type": "number",
        "description": "Z = n ÷ (n + k)"
      },
      "credibilityPremium": {
        "type": "number",
        "description": "Z·X̄ + (1 − Z)·μ"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "observations": 5,
    "sampleMean": 1200,
    "collectiveMean": 1000,
    "expectedProcessVariance": 40000,
    "varianceOfHypotheticalMeans": 10000
  }
}