This is a preview version of the API intended for early testing and integration. Preview versions are not stable and may include breaking changes before general availability.

SE · Intelligence API · 2026-04-01

CoverageHeldFindings

Covers held per car, condo and villa policy from the metrics service, against the share of peers holding each; shares are fractions (0.46 is 46 %). Every field is nullable: null means the metrics service did not report it, a null list is not an empty one, and a null held is unknown, not false.

benchmarkSnapshotDatestring[date]

benchmarksobject

Not filled by POST /intelligence/metrics: the metrics service returns peer groups' shares only for a lookup without policies, which this API does not send.

peerCountRequiredinteger[int32]

peerDataAvailableboolean

policyLevelArray<CoverageHeldPolicy>

Example

{
  "benchmarkSnapshotDate": "2026-11-02",
  "peerCountRequired": 200,
  "peerDataAvailable": true,
  "policyLevel": [
    {
      "collectionId": "e2a8f4c6-1b9d-4f3a-8e7c-5a0b2d6f9e13",
      "coverageMatched": true,
      "covers": [
        {
          "group": "BASIC_COVERAGE",
          "kind": "package",
          "parameterName": "crisis",
          "peerShare": 0.92
        },
        {
          "group": "BASIC_COVERAGE",
          "held": false,
          "kind": "package",
          "parameterName": "wrongFuel",
          "peerShare": 0.83
        },
        {
          "group": "ADD_ON",
          "held": true,
          "kind": "add_on",
          "parameterName": "assistance",
          "peerShare": 0.46
        },
        {
          "group": "ADD_ON",
          "held": false,
          "kind": "add_on",
          "parameterName": "rental",
          "peerShare": 0.46
        },
        {
          "group": "DEDUCTIBLE_TERMS",
          "held": true,
          "kind": "add_on",
          "parameterName": "deductibleDiscountAnimalCollision",
          "peerShare": 0.62
        }
      ],
      "peerGroup": "SE_30_44|car_full",
      "peerPolicyCount": 25592,
      "peerStatus": "compared",
      "policyGroup": "car_full",
      "productId": "6a1f3c9e-2b7d-4e05-9c84-1d2e3f4a5b6c",
      "scored": true,
      "subType": "carInsurance"
    },
    {
      "collectionId": "e2a8f4c6-1b9d-4f3a-8e7c-5a0b2d6f9e13",
      "coverageMatched": true,
      "covers": [
        {
          "group": "BUILDING_AND_PLOT",
          "held": true,
          "kind": "package",
          "parameterName": "accidentVilla"
        },
        {
          "group": "BUILDING_AND_PLOT",
          "kind": "package",
          "parameterName": "extendedLeakageVilla"
        },
        {
          "group": "OTHER",
          "held": true,
          "kind": "package",
          "parameterName": "additionalCostsVilla"
        }
      ],
      "peerStatus": "group_not_compared",
      "policyGroup": "villa_house_only",
      "productId": "8b2e4d6f-3c1a-4f97-a5d2-7e9c1b3a5d8f",
      "scored": true,
      "subType": "villaInsurance"
    }
  ]
}

{  "benchmarkSnapshotDate": "2026-11-02",  "peerCountRequired": 200,  "peerDataAvailable": true,  "policyLevel": [    {      "collectionId": "e2a8f4c6-1b9d-4f3a-8e7c-5a0b2d6f9e13",      "coverageMatched": true,      "covers": [        {          "group": "BASIC_COVERAGE",          "kind": "package",          "parameterName": "crisis",          "peerShare": 0.92        },        {          "group": "BASIC_COVERAGE",          "held": false,          "kind": "package",          "parameterName": "wrongFuel",          "peerShare": 0.83        },        {          "group": "ADD_ON",          "held": true,          "kind": "add_on",          "parameterName": "assistance",          "peerShare": 0.46        },        {          "group": "ADD_ON",          "held": false,          "kind": "add_on",          "parameterName": "rental",          "peerShare": 0.46        },        {          "group": "DEDUCTIBLE_TERMS",          "held": true,          "kind": "add_on",          "parameterName": "deductibleDiscountAnimalCollision",          "peerShare": 0.62        }      ],      "peerGroup": "SE_30_44|car_full",      "peerPolicyCount": 25592,      "peerStatus": "compared",      "policyGroup": "car_full",      "productId": "6a1f3c9e-2b7d-4e05-9c84-1d2e3f4a5b6c",      "scored": true,      "subType": "carInsurance"    },    {      "collectionId": "e2a8f4c6-1b9d-4f3a-8e7c-5a0b2d6f9e13",      "coverageMatched": true,      "covers": [        {          "group": "BUILDING_AND_PLOT",          "held": true,          "kind": "package",          "parameterName": "accidentVilla"        },        {          "group": "BUILDING_AND_PLOT",          "kind": "package",          "parameterName": "extendedLeakageVilla"        },        {          "group": "OTHER",          "held": true,          "kind": "package",          "parameterName": "additionalCostsVilla"        }      ],      "peerStatus": "group_not_compared",      "policyGroup": "villa_house_only",      "productId": "8b2e4d6f-3c1a-4f97-a5d2-7e9c1b3a5d8f",      "scored": true,      "subType": "villaInsurance"    }  ]}