The Visual Score represents the minimum RSI score within a parcel, influenced by the number of buildings and their individual RSI scores. You can obtain this via the Betterview API.
This article is intended to help you understand where to find the Visual Score in API responses and what this score signifies in terms of roof data analysis.
For parcels with multiple buildings, the Visual Score is the lowest RSI among all buildings, while for single-building parcels, it equals that building's RSI score. Individual building RSI scores can be found separately in the buildings object under each building's score field. The API response includes a visualScore attribute within the grade object, which reflects this minimum RSI value.
Example - Multiple Buildings
The API response includes specific building RSI scores within the buildings object. You’ll also see the visualScore attribute, which in this case, is a score of 90 from Building 1.
{
"buildings": {
"1": {
"areaSqft": 1863,
"score": 90
},
"2": {
"areaSqft": 837,
"score": 95,
"heightFt": 10,
"roofSlopeDeg": 5
},
"3": {
"areaSqft": 470,
"score": 94
},
"4": {
"areaSqft": 195,
"score": 96
},
"5": {
"areaSqft": 179,
"score": 95
}
},
"grade": {
"imageCaptureDate": "2025-11-25",
"value": "N/A",
"visualScore": "90"
}
}
Example - Single Building
This is a response for a parcel with a single building. Here, the visualScore will be the same as the RSI score for that single building.
"buildings": {
"1": {
"areaSqft": 4656,
"score": 97,
"heightFt": 36,
"roofSlopeDeg": 35
}
},
"grade": {
"imageCaptureDate": "2025-12-09",
"value": "N/A",
"visualScore": "97",
}