Skip to main content

Home Consumer Data Request Properties

HomeConsumerDataRequest

NameTypeValidationDescription
firstNamestringRequired
Max Length: 64
The insured's first name.
middleNameInitialstringMax Length: 1The insured's middle name initial.
lastNamestringRequired
Max Length: 64
The insured's last name.
dateOfBirthstringFormat: ISO 8601The insured's date of birth.
emailstringRequired
Max Length: 100
Should be a valid email address
The insured's email address.
phonestringRequired
Min Length: 10
Should be a valid phone number
The insured's phone number.
campaignCodestringRequired
Max Length: 8
The campaign code.
productDataHomeQuoteQuestionsRequiredThe home specific data. See the definition of HomeQuoteQuestions below.
metadataOrderedMap[string, string]Max Number of Items:10
Key Max Length: 100
Value Max Length: 100
Metadata that can be passed along with the request, and is returned with each response. Can be used for customer specific information.

HomeQuoteQuestions

NameTypeValidationDescription
addressAddressRequiredThe insured's address. See the definition of Address below.
genderstringShould be one of the values from the Gender listThe insured's gender.
propertyPurchasedInLastSixMonthsbooleanWhether the property was purchased in the last six months.
previousAddressAddressOnly required if propertyPurchasedInLastSixMonths is trueThe address that the insured used to live in.
mortgageeLenderMortgageeLenderThe mortgagee lender information.
propertyDetailsPropertyDetailsRequiredThe property details.
carrierstringThe insured's current insurance carrier.
coverageYearsstringMust be a number between 1 and 32767The insured's current insurance coverage years.
ratingstringMax Length: 64The insured's credit rating.
coApplicantCoApplicantThe details of a CoApplicant.
occupationstringThe insured's Occupation
policyExpirationDatestringFormat: ISO 8601The insured's policy expiration date.
currentPremiumstringMust be a numberThe insured's policy current premium.

Address

NameTypeValidationDescription
streetNumberstringMax Length: 50The street number. (if applicable)
addressLine1stringRequired
Max Length: 255
The first line of the address.
addressLine2stringMax Length: 255The second line of the address (if applicable)
apartmentNumberstringMax Length: 50The apartment number (if applicable).
citystringRequired
Max Length: 50
The city.
countystringMax Length: 50The county.
statestringRequired
Min Length: 2
The US Postal Service state code.
zipstringRequired
Min Length: 5
Max Length: 5
The ZIP code.

MortgageeLender

NameTypeValidationDescription
companyNamestringRequired
Max Length: 255
The mortgagee lender's company name.
addressLine1stringRequired
Max Length: 255
The mortgagee lender's address line 1.
addressLine2stringMax Length: 255The mortgagee lender's address line 2.
citystringRequired
Max Length: 50
The mortgagee lender's address city.
statestringRequired
Max Length: 2
The mortgagee lender's address state.
zipstringRequired
Max Length: 5
The mortgagee lender's address zip code.
loanNumberstringRequired
Min Length: 5
Max Length: 5
The mortgagee lender's loan number.
  • These values are only required if the mortgageeLender object is included in the request.

PropertyDetails

NameTypeValidationDescription
propertyTypestringShould be one of the values from the PropertyType listThe type of property.
ResidenceUsagestringShould be one of the values from the ResidenceUsage listThe primary usage of the property.
yearBuiltstringMust be a year only. Not over 100 years ago. Not in the futureYear in which the house was built.
squareFootagestringMust be a number between 1 and 32767.The square footage of the property.
roofMaterialstringShould be one of the values from the RoofMaterial listThe roof material of the property.
BedroomsstringShould be a numberThe number of bedrooms the property has.
BathroomsstringShould be a numberThe number of bathrooms the property has.
MarketValuestringShould be a numberThe market value of the property.
fireAlarmstringShould be one of the values from the FireAlarm listWhat type of fire alarm the property has.
burglarAlarmstringShould be one of the values from the BurglarAlarm listWhat type of burglar alarm the property has.
gatedCommunitybooleanWhether the property is in a gated community.

List Values

BurglarAlarm

  • Unspecified
  • None
  • Local
  • CentrallyMonitored

FireAlarm

  • Unspecified
  • None
  • Local
  • CentrallyMonitored

Gender

  • Male
  • Female

PropertyType

  • Unspecified
  • Other
  • SingleFamily
  • Condominium
  • Townhouse
  • MobileOrManufactured
  • MultiFamily
  • Duplex

ResidenceUsage

  • Unspecified
  • Other
  • PrimaryResidence
  • SecondaryHome
  • Rental
  • Vacant

RoofMaterial

  • Unspecified
  • Other
  • StandardShingle
  • RatedShingle
  • WoodShingle
  • FlatConcreteOrClayTile
  • Metal
  • ClayOrConcrete
  • Flat
  • RolledPaperFlat