Routes
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
Statistical metrics over a person's or a set of collections' wealth products and insurance policies
POSThttps://api.anessa.co/intelligence/metrics
Draft. Resolves the sources to one portfolio per product line (newest collection per company) and returns each metric's findings as data, never text.
Request
Header Parameters
Insurely-Versionstringrequired
The API version to use, as YYYY-MM-DD. Must match the version of the endpoint you are targeting. A request without it, or with a version older than the client's minimum API version, is served by the client's minimum API version.
Possible Enum values are
2026-04-01.Request Body
metricsArray<string>
Metric names; when omitted, every supported metric the sources may ask for. wealth.concentration reads the wealth line (over a USER source, for a client in the wealth product line only), insurance.coverage_held the insurance line (car, condo and villa policies)
One USER, or one or more COLLECTIONs
Responses
cURL
curl https://api.anessa.co/intelligence/metrics \
-H "authorization-token: <authorization-token>" \
-H "Insurely-Version: 2026-04-01" \
-H "Content-Type: application/json" \
-d '{
"metrics": [
"wealth.concentration",
"insurance.coverage_held"
],
"sources": [
{
"kind": "USER",
"userId": "b7e4d2a1-5c3f-4a8e-9d16-2f0c8e7a3b95"
}
]
}' \
-X POSTRESPONSE 200
{
"input": {
"complete": true,
"sources": [
{
"kind": "USER",
"sourceId": "b7e4d2a1-5c3f-4a8e-9d16-2f0c8e7a3b95",
"status": "OK"
},
{
"kind": "COLLECTION",
"sourceId": "2b8d4f6a-0c3e-4a7b-9e1d-6f4a8c2e0b57",
"status": "SUPERSEDED"
},
{
"collectedAt": "2026-10-30",
"kind": "COLLECTION",
"sourceId": "4f6a9c2e-8b1d-4e7a-a3c5-0d9e2f1b6a84",
"status": "OK"
},
{
"collectedAt": "2026-10-30",
"kind": "COLLECTION",
"sourceId": "9c1e7b3a-2d5f-4c8e-b6a0-7e3d1f9a5c26",
"status": "OK"
},
{
"collectedAt": "2026-10-30",
"kind": "COLLECTION",
"sourceId": "e2a8f4c6-1b9d-4f3a-8e7c-5a0b2d6f9e13",
"status": "OK"
}
]
},
"metrics": [
{
"findings": {
"benchmarkSnapshotDate": "2026-11-02",
"fxAsOf": "collected_at",
"fxRatesAvailable": true,
"holdingsCountRequired": 2,
"input": {
"inputComplete": true,
"productsExcludedByCategory": 1,
"productsExcludedStale": 0,
"productsIncluded": 2,
"productsReceived": 3,
"productsUnknownType": 0,
"subsetSelected": false
},
"peerDataAvailable": true,
"productLevel": [
{
"collectionId": "4f6a9c2e-8b1d-4e7a-a3c5-0d9e2f1b6a84",
"effectiveHoldingsCount": 2.33,
"hhi": 0.4284,
"holdingsCount": 4,
"holdingsCountSufficient": true,
"holdingsExcludedNoFx": 0,
"holdingsExcludedNoIsin": 0,
"holdingsExcludedNonPositive": 0,
"largestPositionPct": 0.5886,
"largestPositions": [
{
"isFund": true,
"isin": "SE0000000011",
"name": "Global Index Fund",
"pct": 0.5886
},
{
"isFund": true,
"isin": "SE0000000037",
"name": "Nordic Small Cap Fund",
"pct": 0.2663
},
{
"isFund": false,
"isin": "SE0000000045",
"name": "Example Industrials AB B",
"pct": 0.088
}
],
"productId": "a91f3c5e-7d2b-4e8a-b6c4-3e1d9f7a2c58",
"top3Pct": 0.9429
},
{
"collectionId": "9c1e7b3a-2d5f-4c8e-b6a0-7e3d1f9a5c26",
"effectiveHoldingsCount": 1.32,
"hhi": 0.7592,
"holdingsCount": 2,
"holdingsCountSufficient": true,
"holdingsExcludedNoFx": 0,
"holdingsExcludedNoIsin": 0,
"holdingsExcludedNonPositive": 0,
"largestPositionPct": 0.86,
"largestPositions": [
{
"isFund": true,
"isin": "SE0000000021",
"name": "Generation Fund 1985",
"pct": 0.86
},
{
"isFund": true,
"isin": "SE0000000060",
"name": "Global Bond Fund",
"pct": 0.14
}
],
"productId": "f0b6d4a2-3e8c-4f1a-9d7b-2c5e8a1f6b34",
"top3Pct": 1
}
],
"userLevel": {
"effectiveHoldingsCount": 3.6,
"hhi": 0.2775,
"holdingsCount": 6,
"holdingsCountSufficient": true,
"holdingsExcludedNoFx": 0,
"holdingsExcludedNoIsin": 0,
"holdingsExcludedNonPositive": 0,
"largestPositionPct": 0.3583,
"largestPositions": [
{
"isFund": true,
"isin": "SE0000000021",
"name": "Generation Fund 1985",
"pct": 0.3583
},
{
"isFund": true,
"isin": "SE0000000011",
"name": "Global Index Fund",
"pct": 0.3433
},
{
"isFund": true,
"isin": "SE0000000037",
"name": "Nordic Small Cap Fund",
"pct": 0.1553
}
],
"peer": {
"hhiPercentile": 0.45,
"largestPositionPercentile": 0.35,
"peerMedianEffectiveHoldings": 3.26,
"peerMedianHhi": 0.3064,
"peerMedianHoldingsCount": 8,
"peerMedianLargestPositionPct": 0.4524,
"peerMedianTop3Pct": 0.8313,
"peerP10Hhi": 0.1101,
"peerP25EffectiveHoldings": 1.96,
"peerP25Hhi": 0.1808,
"peerP25HoldingsCount": 4,
"peerP25LargestPositionPct": 0.2965,
"peerP25Top3Pct": 0.6305,
"peerP75EffectiveHoldings": 5.53,
"peerP75Hhi": 0.5105,
"peerP75HoldingsCount": 14,
"peerP75LargestPositionPct": 0.6631,
"peerP75Top3Pct": 0.9833,
"peerP90Hhi": 0.7709,
"peerP90LargestPositionPct": 0.8721,
"peerP90Top3Pct": 1,
"segment": "SE_30_44",
"segmentUserCount": 12052
},
"scope": "combined",
"top3Pct": 0.8569
},
"version": {
"api": 1,
"kernel": "1.7.0",
"methodology": 4
}
},
"name": "wealth.concentration",
"source": "STATISTICAL",
"status": "OK",
"version": 4
},
{
"findings": {
"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"
}
]
},
"name": "insurance.coverage_held",
"source": "STATISTICAL",
"status": "OK",
"version": 2
}
]
}