US ESDB Building Attributes 10.0

Updates exposure data for a location using the US ESDB Building Attributes data product.

The ExposureSource Database (ESDB) compiles comprehensive building attribute data based on a combination of analytics, validation heuristics, and industry exposure data. ESDB data products support a wide variety of applications including the validation and enrichment of location exposure data. ESDB data products are available for locations in the United States only. Using the ESDB, you can both assess and enhance the quality of your current exposure data and provide a solid foundation where no data exists.

Body Params

Request

object
required
object
Responses

Response body
object
array of objects
warnings
object
string

Warning codes:

CodeDescription
FLG_4001Layer option was skipped. Response based on its default value.
FLG_4002Layer option was skipped. Response based on its maximum value.
FLG_4101Hazard values are calculated based on default floodDepth.
FLG_4102Hazard values are calculated based on maximum proximityDistance.
FLG_4103No additional options can be provided to this lookup.
FLG_4201Location not matched in ESDB building attributes database.
FLG_4202Location is not eligible for ESDB building attribute return. Client input occupancy does not match ESDB occupancy.
FLG_4203Location matched in ESDB building attributes database. Where values are not populated, they are not available in database.
FLG_4204Insufficient geocoding information. Lookup will proceed with the default value for the missing field.
FLG_4205The geocoding version used is not recommended for this layer.
FLG_4206Input address has poor geocoding resolution. Response might have limited precision.
FLG_4207The geocoding version used is not recommended for this layer at coarse geocoding resolutions (5 or higher).
FLG_4208Insufficient geocoding information to look up requested data.
FLG_4301No coverage values provided. Ground-up and gross loss cannot be calculated.
FLG_4302One or more grossLoss values were not calculated due to invalid/missing deductibleAmount.
FLG_4304Invalid/missing deductibleType. Valid deductibleTypes are 1 to 5.
FLG_4305Deductible amount is treated as currency amount instead of percentage.
FLG_4306Missing required field to perform gross loss calculations.
FLG_4307Gross losses can only be calculated for reference view.
FLG_4400[User input] is not a valid value for this layer option. Response based on default value.
FLG_4401No data found for this location.
FLG_4500The combination of input characteristics has not been found, no results have been provided.
FLG_4402[LayerOption] is only valid for version 21 and has been ignored
FLG_4403The location entered is outside of supported region, Response based on default value
string
integer

Client location id for purposes of matching input and output

string
length ≤ 7

Potential for multiple buildings

integer

Represents the building to be returned when multiple buildings exist. Yes=1; No=0

integer

Indicates whether the record is part of HD data set

integer

Attribute that represents the number of floors for a structure. It is a single number, such as 6 or 22, not a range of numbers. Structures are classified according to the number of floors they have.

string
length ≤ 1

Flag for source of numOfStories data returned

integer

Floor area is a primary building characteristic that represents a building's total living area, across all floors. It excludes garages, porches, decks, sunrooms, and basements.

string
length ≤ 1

Flag for source of floorArea data returned

integer

Attribute describing the year when a structure was constructed. For many RMS peril models, year built is a primary vulnerability attribute.

string
length ≤ 1

Flag for source of yearBuilt data returned

integer

Building Height in feet

string
length ≤ 16

Construction combines both scheme and class. Construction scheme (e.g., ATC) is represented by the letters at the beginning. It is a system used for classifying a building's construction class. Construction class is represented by the number(s) following the scheme. It is an attribute referring to the dominant material used in constructing the building frame/structure. Unknown=0.

string
length ≤ 1

Flag for source of construction data returned

string
length ≤ 16

Occupancy combines both scheme and type. Occupancy scheme (e.g., ATC) is represented by the letters at the beginning. It is the classification used for identifying a building's occupancy type. Occupancy type is represented by the number(s) following the scheme. It is an attribute that describes the typical or dominant use of the building (e.g., residential, or schools, or commercial usage). Unknown=0.

string
length ≤ 1

Flag for source of occupancy data returned

string
length ≤ 16

Second Occupancy Scheme and Code

string
length ≤ 16

Third Occupancy Scheme and Code

string
length ≤ 16

Code for modifier that captures the presence of roof covering that affects losses depending on the uplift resistance of the roof cover elements and their replacement costs.

string
length ≤ 256

Roofing material description

string
length ≤ 256

Air conditioning description

string
length ≤ 256

Modifier that describes the exterior of the building (cladding) with respect to its damageability and performance in earthquakes, floods, severe convective storms, and windstorms.

string
length ≤ 16

Code for modifier that captures the roof geometry, which determines the magnitude and extent of wind forces experienced on the roof.

string
length ≤ 256

Roof Geometry description

string
length ≤ 3

Modifier used in RMS products that captures the number of floors occupied, either a single floor or a range of floors. Positive numbers represent floors above grade, and negative numbers represent floors below grade (basement levels).

string
length ≤ 256

Basement description

string
length ≤ 256

Attribute that captures this differentiating factor for flood risk. This attribute is used to infer the height of the first floor during hazard retrieval.

string
length ≤ 256

Type of heating

string
length ≤ 5

Count of bathrooms

string
length ≤ 5

Count of bedrooms

string
length ≤ 5

Count of units in building (if MFD)

string
length ≤ 80

Presence of Pool

string
length ≤ 256

Modifier that captures the presence of garages to specify where automobiles are parked and the relative protection from hail and similar hazards.

double

Maximum probable building value for given property

double

Minimum probable building value for given property

string
length ≤ 3

Currency of valuation. Two- or three-letter ISO code used to represent an individual currency.

double

ESDB version id

Language
URL