Use when the person wants a Premium Lock quote. Creates a Premium Lock quote from a home's address or a car's VIN and the person's current insurance policy. The person's email goes in insured.email. Returns a quote_id; call get_quote until its status is complete.
Premium Lock is not insurance or a financial derivative. Prices are set by Eventual's own pricing, not by the assistant. The person pays on eventualclimate.com; the assistant never charges anyone. Send only the fields a tool lists; never send conversation content or anything else about the person.
Gathering order: first ask for the consumer's email. Then ask whether they have their home or auto declarations page to share. If they give a link to it, send it to read_declarations_page as document_url; if they attach the file, call request_document_upload, give them the upload_url, and once they say it's uploaded call read_declarations_page with the upload_id. Pass the fields it returns to create_quote. If they have no declarations page, ask the consumer for the fields create_quote needs.
View input schema
{
"type": "object",
"properties": {
"insured": {
"description": "The person the quote is for. Put their email in email; every other field is optional, and checkout asks for anything missing.",
"properties": {
"first_name": {
"maxLength": 255,
"type": "string",
"title": "First Name"
},
"last_name": {
"maxLength": 255,
"type": "string",
"title": "Last Name"
},
"email": {
"format": "email",
"type": "string",
"title": "Email"
},
"phone": {
"maxLength": 255,
"type": "string",
"title": "Phone"
}
},
"title": "PartnerInsuredBlock",
"type": "object"
},
"policy": {
"description": "The home insurance policy being quoted. Money in dollars; dates as calendar dates (YYYY-MM-DD).",
"properties": {
"full_address": {
"maxLength": 255,
"minLength": 1,
"title": "Full Address",
"type": "string"
},
"carrier_name": {
"enum": [
"aaa",
"aegis",
"acuity",
"agraria",
"alfainsurance",
"alliedtrust",
"allstate",
"americaneuropean",
"americanguaranteeandliability",
"americanintegrityinsurance",
"americanmodern",
"americannational",
"americanrisk",
"americanstrategic",
"americantraditions",
"amfam",
"amica",
"amshield",
"amwins",
"andover",
"arbella",
"arkansasfarmbureau",
"assurant",
"auros",
"autoowners",
"bamboo",
"bearrivermutual",
"benchmark",
"bentoakmutual",
"berkshirehathawayguardinsurancecompanies",
"berkshirehathwayhomestate",
"bloomfieldmutual",
"branch",
"brethrenmutual",
"bristolwestinsurance",
"burnswilcox",
"cabrillocoastal",
"cajununderwriters",
"californiacasualty",
"celina",
"centralinsurancecompanies",
"chubb",
"cincinnatifinancialgroup",
"coastal",
"coloradofarmbureau",
"connectbyamfam",
"countryfinancial",
"csaa",
"cse",
"cumberlandmutual",
"cure",
"cypress",
"dairyland",
"dbinsurance",
"directauto",
"donegalgroup",
"edison",
"elephant",
"encompass",
"enumclaw",
"erie",
"esurance",
"evanston",
"farmers",
"farmersunion",
"farmbureaufinancialservices",
"fednatinsuranceflorida",
"firstacceptance",
"firstcapital",
"floridafarmbureau",
"floridapeninsulainsurance",
"fmne",
"foremost",
"fortegra",
"frankenmuth",
"franklinmutual",
"fredloya",
"frontline",
"gainsco",
"geico",
"georgiafarmbureau",
"germania",
"goodvillemutual",
"goauto",
"grange",
"greaternewyorkmutualinsurancecompany",
"greatnorthwest",
"gulfstate",
"hagerty",
"hanover",
"hcigroup",
"henrycountymutual",
"heritageinsurance",
"hippo",
"homeownersofamerica",
"homesite",
"homesteadmutual",
"horacemann",
"idahofarmbureau",
"inclinecasualtycompany",
"indianafarmbureau",
"integritypc",
"iowafarmbureau",
"ironinsurancepartners",
"kemperauto",
"kemperpersonalinsurance",
"kentuckyfarmbureau",
"kingstone",
"kininsurance",
"lemonade",
"libertymutual",
"lilypad",
"loggerhead",
"louisianafarmbureau",
"lumenselect",
"mangrovepropertyinsurancecompany",
"mapfre",
"mcmillanwarner",
"meemic",
"mercury",
"metlife",
"metromile",
"michiganfarmbureau",
"midvaleinsuranceauto",
"midvaleinsurancehome",
"mississippifarmbureau",
"missourifarmbureau",
"mmg",
"nationalfarmersunion",
"nationalgeneral",
"nationwide",
"njm",
"northernneck",
"northcarolinafarmbureau",
"northstar",
"nycm",
"oceanharbor",
"oldrepublicunion",
"olympusinsurance",
"openly",
"orion180",
"oswegocountymutual",
"other",
"pacificspecialty",
"patriot",
"pekininsurance",
"pemcomutual",
"pennnational",
"peoplestrust",
"pioneer",
"plymouthrock",
"praetorian",
"preferredmutual",
"progressive",
"propertyinsurancecompanyamerica",
"providence",
"pureinsurance",
"quincymutual",
"root",
"rvos",
"safeco",
"safepoint",
"safetyinsurance",
"safeway",
"sagesure",
"securityfirstflorida",
"selective",
"shelter",
"slideinsurance",
"southernfarmbureau",
"southernoakins",
"southcarolinafarmbureau",
"stateauto",
"statefarm",
"sterling",
"stillwater",
"strathmoreinsurancecompany",
"summitspecialtyinsurancecompany",
"surechoice",
"suttonnational",
"swyfft",
"tennesseefarmbureau",
"tesla",
"texasfarmbureau",
"thegeneral",
"thehartford",
"towerhillinsurance",
"travelers",
"trexis",
"21stcentury",
"uaic",
"unionmutual",
"universalnorthamerica",
"universalproperty",
"upcinsurance",
"usaa",
"utica",
"vault",
"vermontmutual",
"vyrd",
"wawanesa",
"wayne",
"westchestersurpluslines",
"westernnational",
"westfield",
"westbend",
"americaninternationalgroup",
"berkley",
"brookfieldwealthsolutionsgrp",
"clearblueinsurance",
"encova",
"iatreinsco",
"kwspecialty",
"lloyds",
"mainstreetamerica",
"markelinsurance",
"munich",
"philadelphia",
"qbe",
"sh1holdings",
"tokiomarine",
"wrightflood",
"zurich",
"aiua",
"cpfa",
"citizenspropertyinsurance",
"guaa",
"illinoisfairplan",
"louisianacitizens",
"mbpia",
"missourifairplan",
"mjia",
"mpiua",
"mrpiua",
"nccoastalpool",
"ncjua",
"newjerseyfair",
"nypiua",
"ohiofairplan",
"rijra",
"texasfairplan",
"vpia"
],
"title": "CarrierName",
"type": "string"
},
"carrier_friendly_name": {
"maxLength": 255,
"type": "string",
"title": "Carrier Friendly Name"
},
"total_premium": {
"exclusiveMinimum": 0,
"type": "number",
"description": "Annual premium in dollars. A new quote above $10,000 is refused with 422 `home_premium_above_maximum`.",
"title": "Total Premium"
},
"per_incident_limit": {
"exclusiveMinimum": 0,
"type": "number",
"description": "Dwelling / per-incident coverage limit in dollars",
"title": "Per Incident Limit"
},
"deductible": {
"minimum": 0,
"type": "number",
"description": "Deductible in dollars",
"title": "Deductible"
},
"expiry_date": {
"format": "date",
"title": "Expiry Date",
"type": "string"
},
"renewal_date": {
"format": "date",
"title": "Renewal Date",
"type": "string"
},
"no_claims": {
"type": "boolean",
"title": "No Claims"
},
"admitted_lines_confirmed": {
"default": false,
"description": "True when this policy is written on admitted lines. Required for an excess-and-surplus carrier: without it the quote is refused with 422 `product_line_ineligible`. A last-resort carrier is refused either way.",
"title": "Admitted Lines Confirmed",
"type": "boolean"
}
},
"required": [
"full_address",
"carrier_name",
"total_premium",
"per_incident_limit",
"deductible",
"expiry_date",
"renewal_date"
],
"title": "PartnerPolicyBlock",
"type": "object"
},
"product_line": {
"default": "home",
"enum": [
"home",
"auto",
"bundle"
],
"title": "Product Line",
"type": "string"
},
"auto": {
"description": "The auto insurance policy, for an auto or bundle quote. Money in dollars. The policy start date is when the policy term the Premium Lock starts on begins, and is held to the same 90-day window as a home renewal.",
"properties": {
"carrier_name": {
"enum": [
"aaa",
"aegis",
"acuity",
"agraria",
"alfainsurance",
"alliedtrust",
"allstate",
"americaneuropean",
"americanguaranteeandliability",
"americanintegrityinsurance",
"americanmodern",
"americannational",
"americanrisk",
"americanstrategic",
"americantraditions",
"amfam",
"amica",
"amshield",
"amwins",
"andover",
"arbella",
"arkansasfarmbureau",
"assurant",
"auros",
"autoowners",
"bamboo",
"bearrivermutual",
"benchmark",
"bentoakmutual",
"berkshirehathawayguardinsurancecompanies",
"berkshirehathwayhomestate",
"bloomfieldmutual",
"branch",
"brethrenmutual",
"bristolwestinsurance",
"burnswilcox",
"cabrillocoastal",
"cajununderwriters",
"californiacasualty",
"celina",
"centralinsurancecompanies",
"chubb",
"cincinnatifinancialgroup",
"coastal",
"coloradofarmbureau",
"connectbyamfam",
"countryfinancial",
"csaa",
"cse",
"cumberlandmutual",
"cure",
"cypress",
"dairyland",
"dbinsurance",
"directauto",
"donegalgroup",
"edison",
"elephant",
"encompass",
"enumclaw",
"erie",
"esurance",
"evanston",
"farmers",
"farmersunion",
"farmbureaufinancialservices",
"fednatinsuranceflorida",
"firstacceptance",
"firstcapital",
"floridafarmbureau",
"floridapeninsulainsurance",
"fmne",
"foremost",
"fortegra",
"frankenmuth",
"franklinmutual",
"fredloya",
"frontline",
"gainsco",
"geico",
"georgiafarmbureau",
"germania",
"goodvillemutual",
"goauto",
"grange",
"greaternewyorkmutualinsurancecompany",
"greatnorthwest",
"gulfstate",
"hagerty",
"hanover",
"hcigroup",
"henrycountymutual",
"heritageinsurance",
"hippo",
"homeownersofamerica",
"homesite",
"homesteadmutual",
"horacemann",
"idahofarmbureau",
"inclinecasualtycompany",
"indianafarmbureau",
"integritypc",
"iowafarmbureau",
"ironinsurancepartners",
"kemperauto",
"kemperpersonalinsurance",
"kentuckyfarmbureau",
"kingstone",
"kininsurance",
"lemonade",
"libertymutual",
"lilypad",
"loggerhead",
"louisianafarmbureau",
"lumenselect",
"mangrovepropertyinsurancecompany",
"mapfre",
"mcmillanwarner",
"meemic",
"mercury",
"metlife",
"metromile",
"michiganfarmbureau",
"midvaleinsuranceauto",
"midvaleinsurancehome",
"mississippifarmbureau",
"missourifarmbureau",
"mmg",
"nationalfarmersunion",
"nationalgeneral",
"nationwide",
"njm",
"northernneck",
"northcarolinafarmbureau",
"northstar",
"nycm",
"oceanharbor",
"oldrepublicunion",
"olympusinsurance",
"openly",
"orion180",
"oswegocountymutual",
"other",
"pacificspecialty",
"patriot",
"pekininsurance",
"pemcomutual",
"pennnational",
"peoplestrust",
"pioneer",
"plymouthrock",
"praetorian",
"preferredmutual",
"progressive",
"propertyinsurancecompanyamerica",
"providence",
"pureinsurance",
"quincymutual",
"root",
"rvos",
"safeco",
"safepoint",
"safetyinsurance",
"safeway",
"sagesure",
"securityfirstflorida",
"selective",
"shelter",
"slideinsurance",
"southernfarmbureau",
"southernoakins",
"southcarolinafarmbureau",
"stateauto",
"statefarm",
"sterling",
"stillwater",
"strathmoreinsurancecompany",
"summitspecialtyinsurancecompany",
"surechoice",
"suttonnational",
"swyfft",
"tennesseefarmbureau",
"tesla",
"texasfarmbureau",
"thegeneral",
"thehartford",
"towerhillinsurance",
"travelers",
"trexis",
"21stcentury",
"uaic",
"unionmutual",
"universalnorthamerica",
"universalproperty",
"upcinsurance",
"usaa",
"utica",
"vault",
"vermontmutual",
"vyrd",
"wawanesa",
"wayne",
"westchestersurpluslines",
"westernnational",
"westfield",
"westbend",
"americaninternationalgroup",
"berkley",
"brookfieldwealthsolutionsgrp",
"clearblueinsurance",
"encova",
"iatreinsco",
"kwspecialty",
"lloyds",
"mainstreetamerica",
"markelinsurance",
"munich",
"philadelphia",
"qbe",
"sh1holdings",
"tokiomarine",
"wrightflood",
"zurich",
"aiua",
"cpfa",
"citizenspropertyinsurance",
"guaa",
"illinoisfairplan",
"louisianacitizens",
"mbpia",
"missourifairplan",
"mjia",
"mpiua",
"mrpiua",
"nccoastalpool",
"ncjua",
"newjerseyfair",
"nypiua",
"ohiofairplan",
"rijra",
"texasfairplan",
"vpia"
],
"title": "CarrierName",
"type": "string"
},
"carrier_friendly_name": {
"maxLength": 255,
"type": "string",
"title": "Carrier Friendly Name"
},
"state": {
"maxLength": 2,
"minLength": 2,
"title": "State",
"type": "string"
},
"garaging_address": {
"maxLength": 255,
"minLength": 1,
"type": "string",
"description": "Where the cars are kept. On a bundle, the home's address when omitted.",
"title": "Garaging Address"
},
"policy_start_date": {
"format": "date",
"title": "Policy Start Date",
"type": "string"
},
"policy_term_months": {
"enum": [
6,
12
],
"title": "Policy Term Months",
"type": "integer"
},
"claims_and_tickets_eligible": {
"default": true,
"description": "The household's Claims & Tickets Eligibility choice, applied to every car.",
"title": "Claims And Tickets Eligible",
"type": "boolean"
},
"no_claims": {
"type": "boolean",
"description": "True for no car insurance claim in the last 12 months. Unanswered prices as no claim.",
"title": "No Claims"
},
"business_use_confirmed": {
"default": false,
"description": "The consumer confirms their policy covers each car's business use. Required when any car's `usage` is `business`.",
"title": "Business Use Confirmed",
"type": "boolean"
},
"admitted_lines_confirmed": {
"default": false,
"description": "True when this policy is written on admitted lines. Required for an excess-and-surplus carrier: without it the quote is refused with 422 `product_line_ineligible`. A last-resort carrier is refused either way.",
"title": "Admitted Lines Confirmed",
"type": "boolean"
},
"vehicles": {
"items": {
"description": "One car on the policy. Each car is its own Premium Lock, priced from its own share of the policy-term premium.",
"properties": {
"vin": {
"maxLength": 17,
"minLength": 1,
"title": "Vin",
"type": "string"
},
"allocated_premium": {
"exclusiveMinimum": 0,
"type": "number",
"description": "This car's share of the premium for one policy term, in dollars: the per-vehicle premium the declarations page prints.",
"title": "Allocated Premium"
},
"vehicle_year": {
"maximum": 2100,
"minimum": 1900,
"type": "integer",
"title": "Vehicle Year"
},
"vehicle_make": {
"maxLength": 64,
"type": "string",
"title": "Vehicle Make"
},
"vehicle_model": {
"maxLength": 64,
"type": "string",
"title": "Vehicle Model"
},
"usage": {
"description": "How the car is used. A `business` car needs `business_use_confirmed`.",
"enum": [
"commute",
"pleasure",
"business",
"farm",
"other"
],
"title": "AutoVehicleUsage",
"type": "string"
}
},
"required": [
"vin",
"allocated_premium"
],
"title": "AutoVehicleInput",
"type": "object"
},
"maxItems": 10,
"minItems": 1,
"title": "Vehicles",
"type": "array"
}
},
"required": [
"carrier_name",
"state",
"policy_start_date",
"policy_term_months",
"vehicles"
],
"title": "AutoPolicyBlock",
"type": "object"
},
"referral_token": {
"type": "string",
"description": "A signed referral token, when the person arrived through a referral link. A token that doesn't verify is ignored and the quote is made anyway.",
"title": "Referral Token"
},
"idempotency_key": {
"type": "string",
"maxLength": 255,
"description": "Optional. Defaults to a hash of the body, so a repeated call returns the first quote instead of creating another."
}
}
}