--- title: "Generate a new quote (single product)" method: POST path: "/v1/quote" tags: ["Quote"] --- # Generate a new quote (single product) `POST /v1/quote` Generates a price quote for a single product based on specified information. ## Headers - `Authorization` string ## Request body - CreateQuoteDto - `advisorId` string — A unique identifier for the agent triggering this quote - `departureDate` string, date, required — First day of trip - `returnDate` string, date, required — Final day of trip - `destination` Destination[], required — Array of travel destinations. Each destination must provide either a country code (Alpha-2 format like US, AU) or googlePlaceId. State (areaLevel1) is optional for US destinations. - `country` string — Country code - `googlePlaceId` string — google place ID - `state` string — State code - `tripCost` number — Value of non-refundable trip costs in $USD. Minimum $1000. Maximum is $150,000 or $50,000 per traveler (the lower between them) - `coverageOptions` AddonsRequestDto - `petOption` StandardCoverageOptionRequestDto - `selected` boolean — If this option is desired - `trcOption` StandardCoverageOptionRequestDto - `selected` boolean — If this option is desired - `cfarOption` InitialDepositBaseCoverageOptionRequestDto - `selected` boolean — If this option is desired - `initialDepositDate` string — Initial deposit date - `cfwrOption` InitialDepositBaseCoverageOptionRequestDto - `selected` boolean — If this option is desired - `initialDepositDate` string — Initial deposit date - `adventureOption` StandardCoverageOptionRequestDto - `selected` boolean — If this option is desired - `vacationRentalOption` StandardCoverageOptionRequestDto - `selected` boolean — If this option is desired - `medicalUpgrade` StandardCoverageOptionRequestDto - `selected` boolean — If this option is desired - `carRentalOption` CarRentalCoverageRequestDto - `selected` boolean — If this option is desired - `carDatesDto` CarDateDto[], required - `startDate` string, date-time, required — Start date of car rental - `endDate` string, date-time, required — End date of car rental - `noOfCars` number — Number of cars - `noOfCars` number — Number of cars. Defaults to 1 - `productId` 'PR-STANDARD-01' | 'PR-SPORTS-01' | 'PR-CFAR-01' | 'PR-STANDARD-DO' | 'PR-SPORTS-DO' | 'PR-CFAR-DO' | 'PR-STR' | 'PR-GENERAL-STR' | 'RETAIL' | 'PR-FirstCountrywide' | 'PR-ForwardCountrywide' | 'PR-FlagshipCountrywide' — Product ID - relevant only for specific partners. Single product for single quote. - `productIds` string[] — Array of product IDs or group names for multi-quote. If provided, will create quotes for all products. Can contain ProductIdEnum values or group names. - `productCode` string, required — The product code to quote for, this field is no longer used - `timezone` string — Timezone for the trip dates (IANA timezone identifier) - `residence` string, required — State of residence (USA) of all travelers. If some travelers are in different states, please quote for each state. - `travelerDobs` number[], required — List of dates of birth of the travelers. The price is age sensitive. If the full date of birth is missing, you can select Jan 1st of the relevant year. Either this field or travelerDetails must be provided - `travelerDetails` ProspectiveCustomerDto[], required — Personal details of policyholders, note: the first policyholder is the primary policyholder. Either this field or travelerDobs must be provided. Include this field to get the quote page url - `firstName` string, required — First name - `lastName` string, required — Last name - `email` string — Email address - `dob` string, date, required — Date of birth - `externalId` string — The ID of the user on the partner system - `noTravellers` number — The number of travellers - `utms` UtmDto[] — UTM tracking parameters - `key` string, required — UTM parameter key - `value` string, required — UTM parameter value ## Response `201` The quote has been successfully generated. - CreateQuoteResponseDto - `currentPrice` number, required — The price for this quote is in $USD, including all selected add-ons. - `coverageOptions` AddonsDto, required - `petOption` StandardCoverageOptionDto, required - `available` boolean — If this add-on can be added to the purchase - `selected` boolean — If this add-on is selected and included in the price - `price` number — The price to purchase this coverage - `trcOption` StandardCoverageOptionDto, required - `available` boolean — If this add-on can be added to the purchase - `selected` boolean — If this add-on is selected and included in the price - `price` number — The price to purchase this coverage - `cfarOption` StandardCoverageOptionDto, required - `available` boolean — If this add-on can be added to the purchase - `selected` boolean — If this add-on is selected and included in the price - `price` number — The price to purchase this coverage - `cfwrOption` StandardCoverageOptionDto, required - `available` boolean — If this add-on can be added to the purchase - `selected` boolean — If this add-on is selected and included in the price - `price` number — The price to purchase this coverage - `adventureOption` StandardCoverageOptionDto, required - `available` boolean — If this add-on can be added to the purchase - `selected` boolean — If this add-on is selected and included in the price - `price` number — The price to purchase this coverage - `vacationRentalOption` StandardCoverageOptionDto, required - `available` boolean — If this add-on can be added to the purchase - `selected` boolean — If this add-on is selected and included in the price - `price` number — The price to purchase this coverage - `carRentalOption` CarRentalCoverageDto, required - `available` boolean — If this add-on can be added to the purchase - `selected` boolean — If this add-on is selected and included in the price - `price` number — The price to purchase this coverage - `pricePerCarPerDay` number, required — The price to purchase this coverage **per car per day** - `medicalUpgrade` StandardCoverageOptionDto, required - `available` boolean — If this add-on can be added to the purchase - `selected` boolean — If this add-on is selected and included in the price - `price` number — The price to purchase this coverage - `policyExampleUrl` string, required — URL to a PDF document of an example policy. Policy examples change based on the state of residency and whether the trip is domestic or international. By the regulation, it is mandatory to allow the traveler to review an example policy before purchasing. - `quoteUrl` string, required — URL to a printable version of the quote, which highlights the coverage options and price for that specific quote. - `quotePageUrl` string, required — URL to the web page for purchasing the quote - `quoteHash` string, required — Quote hash identifier for this quote - `offerDescription` object, required — Offer page V5 for this quote ## Other responses - `400` — Unable to provide quote for provided parameters - `401` — Unauthorized --- [API](https://skmtc.net/withfaye/apis/faye-partner-sales-api.md) · [All operations](https://skmtc.net/withfaye/apis/faye-partner-sales-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/withfaye/faye-partner-sales-api/revisions/e016afb8fdb3/schema)