Starts a real-time price quote for a California auto, home, condo, renters, or home and auto policy with Susman Insurance Agency. The details go to the agency's rating service and to the insurance companies it represents, the quote is saved at the agency, and a licensed agent may follow up. It is meant for a real person who has agreed to the consent wording. A driver's license number or Social Security number is not part of a quote, and a request that carries one is refused. The result is either the prices or a reference for reading them once pricing finishes, usually within a minute. Prices are estimates; nothing is bought or bound.
View input schema
{
"type": "object",
"properties": {
"product": {
"type": "string",
"enum": [
"auto",
"home",
"home_and_auto",
"condo",
"renters"
],
"description": "What is quoted: auto, home (homeowners insurance), home and auto together, condo (for a condo or co-op the person owns), or renters (for a home the person rents)."
},
"consent": {
"type": "object",
"description": "The agreement of the person to the consent wording.",
"properties": {
"agreed": {
"type": "boolean",
"enum": [
true
],
"description": "True when the person has read the consent wording and agreed to it."
},
"contactOk": {
"type": "boolean",
"enum": [
true
],
"description": "True when the person has agreed that the agency may contact them about the quote by phone, text or email."
},
"wordingVersion": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "The version of the consent wording the person agreed to."
}
},
"required": [
"agreed",
"contactOk",
"wordingVersion"
],
"additionalProperties": false
},
"applicant": {
"type": "object",
"description": "The person the quote is for. On an auto quote this is also the first driver.",
"properties": {
"firstName": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "First name."
},
"middleInitial": {
"type": "string",
"maxLength": 1,
"description": "Middle initial, one letter."
},
"lastName": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Last name."
},
"dateOfBirth": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date of birth. Format YYYY-MM-DD."
},
"gender": {
"type": "string",
"enum": [
"Female",
"Male"
],
"description": "Gender, as the rating service records it."
},
"maritalStatus": {
"type": "string",
"enum": [
"Single",
"Married",
"Separated",
"Divorced",
"Widowed",
"Domestic partner"
],
"description": "Marital status."
},
"industry": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Employment industry, from the current list of industries."
},
"occupation": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Occupation, from the current list of occupations within that industry."
},
"incidents": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"description": "One accident, violation or comprehensive loss in the past five years.",
"properties": {
"type": {
"type": "string",
"enum": [
"Accident",
"Violation",
"Comprehensive loss"
],
"description": "The kind of incident."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}(-\\d{2})?$",
"description": "The month it happened. Format YYYY-MM."
},
"accidentType": {
"type": "string",
"enum": [
"At fault, someone was hurt",
"At fault, no one was hurt",
"Not at fault"
],
"description": "For an accident: who was at fault and whether anyone was hurt."
},
"violationType": {
"type": "string",
"enum": [
"Careless Driving",
"Defective Equipment",
"Driving on Suspended License",
"DUI",
"Failure to Obey Signal",
"Speeding",
"Other Major",
"Other Minor",
"Not Listed"
],
"description": "For a violation: the kind of violation."
},
"lossType": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "For a comprehensive loss: what happened, for example theft, glass, weather or vandalism."
}
},
"required": [
"type",
"date"
],
"additionalProperties": false
},
"description": "Accidents, violations and comprehensive losses of this driver in the past five years. Empty when there are none. Part of auto quotes."
},
"email": {
"type": "string",
"format": "email",
"maxLength": 254,
"description": "Email address of the person."
},
"phone": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "US phone number of the person, 10 digits."
},
"preferredContact": {
"type": "string",
"enum": [
"Email",
"Phone",
"Text"
],
"description": "How the person prefers to be reached."
}
},
"required": [
"firstName",
"lastName",
"dateOfBirth",
"gender",
"maritalStatus",
"email",
"phone",
"preferredContact",
"industry",
"occupation"
],
"additionalProperties": false
},
"address": {
"type": "object",
"description": "The home address, or where the vehicles are kept. California only.",
"properties": {
"line1": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Street address."
},
"line2": {
"type": "string",
"maxLength": 80,
"description": "Apartment or unit."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "City."
},
"state": {
"type": "string",
"enum": [
"CA"
],
"description": "State. Quotes are for California addresses."
},
"zip": {
"type": "string",
"pattern": "^9\\d{4}$",
"description": "Five-digit California ZIP code."
}
},
"required": [
"line1",
"city",
"state",
"zip"
],
"additionalProperties": false
},
"additionalDrivers": {
"type": "array",
"maxItems": 5,
"description": "Other drivers in the household, up to five. Part of auto quotes.",
"items": {
"type": "object",
"properties": {
"firstName": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "First name."
},
"middleInitial": {
"type": "string",
"maxLength": 1,
"description": "Middle initial, one letter."
},
"lastName": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Last name."
},
"dateOfBirth": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date of birth. Format YYYY-MM-DD."
},
"gender": {
"type": "string",
"enum": [
"Female",
"Male"
],
"description": "Gender, as the rating service records it."
},
"maritalStatus": {
"type": "string",
"enum": [
"Single",
"Married",
"Separated",
"Divorced",
"Widowed",
"Domestic partner"
],
"description": "Marital status."
},
"industry": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Employment industry, from the current list of industries."
},
"occupation": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Occupation, from the current list of occupations within that industry."
},
"incidents": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"description": "One accident, violation or comprehensive loss in the past five years.",
"properties": {
"type": {
"type": "string",
"enum": [
"Accident",
"Violation",
"Comprehensive loss"
],
"description": "The kind of incident."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}(-\\d{2})?$",
"description": "The month it happened. Format YYYY-MM."
},
"accidentType": {
"type": "string",
"enum": [
"At fault, someone was hurt",
"At fault, no one was hurt",
"Not at fault"
],
"description": "For an accident: who was at fault and whether anyone was hurt."
},
"violationType": {
"type": "string",
"enum": [
"Careless Driving",
"Defective Equipment",
"Driving on Suspended License",
"DUI",
"Failure to Obey Signal",
"Speeding",
"Other Major",
"Other Minor",
"Not Listed"
],
"description": "For a violation: the kind of violation."
},
"lossType": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "For a comprehensive loss: what happened, for example theft, glass, weather or vandalism."
}
},
"required": [
"type",
"date"
],
"additionalProperties": false
},
"description": "Accidents, violations and comprehensive losses of this driver in the past five years. Empty when there are none. Part of auto quotes."
},
"relationship": {
"type": "string",
"enum": [
"Spouse",
"Parent",
"Child",
"Domestic partner",
"Other"
],
"description": "Relationship to the applicant."
}
},
"required": [
"firstName",
"lastName",
"dateOfBirth",
"gender",
"maritalStatus",
"relationship",
"industry",
"occupation"
],
"additionalProperties": false
}
},
"vehicles": {
"type": "array",
"maxItems": 6,
"description": "The vehicles to quote, one to six. Part of auto quotes.",
"items": {
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1900,
"maximum": 2100,
"description": "Model year."
},
"make": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Make, as the current list of makes for that year spells it."
},
"model": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Model, as the current list of models for that make spells it."
},
"styleId": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "The body style, as the id the current list of body styles gives it."
},
"vin": {
"type": "string",
"pattern": "^[A-HJ-NPR-Za-hj-npr-z0-9]{17}$",
"description": "The 17-character VIN, when the person has it. It is kept for the agency and is not used for pricing."
},
"primaryDriver": {
"type": "integer",
"minimum": 0,
"maximum": 5,
"description": "Who drives this vehicle most: 0 is the applicant, 1 the first additional driver, and so on. The applicant when left out."
},
"use": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Primary use, from the current list of uses."
},
"annualMiles": {
"type": "integer",
"minimum": 0,
"maximum": 1000000,
"description": "Miles driven in a year."
},
"milesToWork": {
"type": "integer",
"minimum": 0,
"maximum": 10000,
"description": "Miles to work, one way."
}
},
"required": [
"year",
"make",
"model",
"styleId",
"use",
"annualMiles"
],
"additionalProperties": false
}
},
"home": {
"type": "object",
"description": "The home to quote. Part of home, condo and renters quotes.",
"properties": {
"residenceType": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Residence type, from the current list."
},
"yearsAtResidence": {
"type": "integer",
"minimum": 0,
"maximum": 120,
"description": "Years the person has lived there. 0 for a new purchase or a recent move."
},
"yearBuilt": {
"type": "integer",
"minimum": 1800,
"maximum": 2100,
"description": "Year the home was built."
},
"squareFeet": {
"type": "integer",
"minimum": 100,
"maximum": 50000,
"description": "Finished square feet."
},
"construction": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Construction, from the current list."
},
"numberOfUnits": {
"type": "integer",
"minimum": 1,
"maximum": 99,
"description": "Number of units in the building. For a condo, co-op or apartment, and on every condo or renters quote."
},
"milesToCoast": {
"type": "integer",
"minimum": 0,
"maximum": 999,
"description": "Distance to the coast in miles. The distance is given in miles, in feet, or both, and is above zero."
},
"feetToCoast": {
"type": "integer",
"minimum": 0,
"maximum": 9999,
"description": "Distance to the coast in feet, for a home less than a mile from it."
},
"roofUpdateYear": {
"type": "integer",
"minimum": 1800,
"maximum": 2100,
"description": "Year the roof was replaced or substantially updated, when it was."
},
"plumbingUpdateYear": {
"type": "integer",
"minimum": 1800,
"maximum": 2100,
"description": "Year the plumbing was substantially updated, when it was."
},
"electricalUpdateYear": {
"type": "integer",
"minimum": 1800,
"maximum": 2100,
"description": "Year the electrical system was substantially updated, when it was."
},
"heatingUpdateYear": {
"type": "integer",
"minimum": 1800,
"maximum": 2100,
"description": "Year the heating system was substantially updated, when it was."
},
"claims": {
"type": "array",
"maxItems": 5,
"description": "Home insurance claims in the past five years. Empty when there are none.",
"items": {
"type": "object",
"properties": {
"cause": {
"type": "string",
"enum": [
"Fire",
"Theft",
"Flood",
"Other"
],
"description": "What the claim was for."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}(-\\d{2})?$",
"description": "The month of the claim. Format YYYY-MM."
}
},
"required": [
"cause",
"date"
],
"additionalProperties": false
}
},
"smokeDetector": {
"type": "boolean",
"description": "Whether the home has working smoke detectors."
},
"fireExtinguisher": {
"type": "boolean",
"description": "Whether the home has a fire extinguisher."
},
"smokersInHousehold": {
"type": "boolean",
"description": "Whether anyone in the household smokes."
}
},
"required": [
"residenceType",
"yearsAtResidence",
"yearBuilt",
"squareFeet",
"construction",
"smokeDetector",
"fireExtinguisher",
"smokersInHousehold"
],
"additionalProperties": false
},
"coverage": {
"type": "object",
"description": "The coverage asked for and the insurance the person has now.",
"properties": {
"policyStartDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The day the new policy would start. Format YYYY-MM-DD."
},
"currentAutoInsurer": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Current auto insurance company as the current list names it, or Other, or None when the person has no auto insurance now. Part of auto quotes."
},
"currentAutoPolicyExpiration": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}(-\\d{2})?$",
"description": "The day the current auto policy expires, YYYY-MM-DD, or the month as YYYY-MM. Goes with a current auto insurer other than None."
},
"currentLiabilityLimits": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Liability limits of the current auto policy, from the current list. Goes with a current auto insurer other than None."
},
"currentHomeInsurer": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Current home, condo or renters insurance company as the current list names it, or Other, or None when the home is not insured now. Part of home, condo and renters quotes."
},
"homeInsurerDifferentFromAuto": {
"type": "boolean",
"description": "On a home and auto quote: whether the home insurer is a different company from the auto insurer."
},
"comprehensiveDeductible": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Comprehensive deductible, from the current list. Part of auto quotes."
},
"collisionDeductible": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Collision deductible, from the current list. Part of auto quotes."
},
"homeDeductible": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Home deductible, from the current list. Part of home, condo and renters quotes."
},
"dwellingCoverage": {
"type": "integer",
"minimum": 10000,
"maximum": 20000000,
"description": "Estimated dwelling coverage in whole dollars. Part of home quotes."
},
"contentsCoverage": {
"type": "integer",
"minimum": 10000,
"maximum": 20000000,
"description": "Estimated value of the contents, the personal belongings in the home, in whole dollars. Part of condo and renters quotes."
}
},
"required": [
"policyStartDate"
],
"additionalProperties": false
},
"agent": {
"type": "object",
"description": "Optional: the assistant or product sending this.",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"description": "Name of the assistant or product."
},
"url": {
"type": "string",
"maxLength": 200,
"description": "Its web address."
},
"contact": {
"type": "string",
"maxLength": 200,
"description": "How its maker can be reached."
}
},
"additionalProperties": false
}
},
"required": [
"product",
"consent",
"applicant",
"address",
"coverage"
],
"additionalProperties": false
}