---
title: "Generate multiple quotes (V2)"
method: POST
path: "/v2/quote/multi"
tags: ["Quote", "Quote & Save V2"]
---

# Generate multiple quotes (V2)

`POST /v2/quote/multi`

Generates price quotes for multiple products using the V2 API endpoint. This endpoint calls the backend /quote/create/quote endpoint.

## Headers

- `Authorization` string

## Request body

- CreateMultiQuoteDtoV2
  - `advisorId` string — A unique identifier for the agent triggering this quote
  - `departureDate` string — First day of trip (V1 format). Either departureDate or tripStartDate must be provided.
  - `returnDate` string — Final day of trip (V1 format). Either returnDate or tripEndDate must be provided.
  - `destination` Destination[] — Array of travel destinations (V1 format). Either destination or destinations must be provided. 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` CfarCoverageOptionRequestDto
      - `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
    - `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 is not allowed for multi-quote. Use productIds or products instead.
  - `productIds` array[] — Array of product IDs or group names for multi-quote (from base class). Required for multi-quote endpoint. Must contain at least 1 product. Can contain ProductIdEnum values or group names.
    - unknown[]
      - unknown
  - `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)
  - `tripStartDate` string, required — Start date of the trip in ISO format (V2 format). Either departureDate or tripStartDate must be provided.
  - `tripEndDate` string, required — End date of the trip in ISO format (V2 format). Either returnDate or tripEndDate must be provided.
  - `destinations` PlaceDetailsDtoV2[], required — List of destinations (V2 format). Either destination or destinations must be provided.
    - `country` string, nullable — Country code (ISO 3166-1 alpha-2)
    - `areaLevel1` string, nullable — State or province code
    - `locality` string, nullable — City or locality
    - `label` string, nullable — Human-readable label for the place
    - `googleId` string, nullable — Google Place ID
    - `fullCountryName` string, nullable — Full country name
  - `product` '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 is not allowed for multi-quote. Use productIds or products instead.
  - `products` array[] — Array of policy products or group names for multi-quote (V2 format). Same as productIds. Required for multi-quote endpoint. Must contain at least 1 product. Can contain ProductIdEnum values or group names.
    - unknown[]
      - unknown
  - `residence` string — Residence information (backward compatibility - accepts string). If provided, it will be used as areaLevel1 in residency. Either residence (string) or residency must be provided.
  - `residency` ResidencyDtoV2
    - `country` string, nullable — Country code (ISO 3166-1 alpha-2)
    - `areaLevel1` string, nullable — State or province code (mandatory in residency)
    - `locality` string, nullable — City or locality
    - `label` string, nullable — Human-readable label for the place
    - `googleId` string, nullable — Google Place ID
    - `fullCountryName` string, nullable — Full country name
    - `streetAndNumber` string, nullable — Street address and number
    - `apartment` string, nullable — Apartment or unit number
    - `zipCode` string, nullable — ZIP or postal code
  - `travellers` TravellerDtoV2[], required — List of travellers
    - `dateOfBirth` string, date-time, required — Date of birth
    - `firstName` string, required — First name
    - `email` string — Email address
    - `lastName` string, required — Last name
    - `isDriver` boolean, required — Whether the traveller is a driver
    - `mainTraveller` boolean, required — Whether this is the main traveller
    - `profileImage` string — Profile image URL or presigned URL
    - `isPlaceHolderTraveller` boolean — Whether this is a placeholder traveller
  - `travelerDetails` ProspectiveCustomerDto[], required — Personal details of policyholders (V1 format). Will be converted to travellers if travellers is not provided. Note: the first policyholder is the primary policyholder.
    - `firstName` string, required — First name
    - `lastName` string, required — Last name
    - `email` string — Email address
    - `dob` string, required — Date of birth
  - `policyCodeHash` string — Policy code hash
  - `utms` UtmDto[] — UTM tracking parameters
    - `key` string, required — UTM parameter key
    - `value` string, required — UTM parameter value
  - `noTravellers` number — The number of travellers

## Response `201`

The quotes have been successfully generated.

- MultiQuoteResponseDto
  - `groupHash` string — The group_hash linking all quotes
  - `quotes` MultiQuoteItemDto[], required — Array of quotes in the group
    - `product` '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', required — Product ID for this quote
    - `quote` 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
        - `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**
      - `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
    - `status` 'offer' | 'quote' — Status of the quote - "offer" or "quote"
    - `error` string — Error message if recalculation failed for this quote
  - `isCompleted` boolean — Whether the group was purchased

## Other responses

- `400` — Unable to provide quotes for provided parameters
- `401` — Unauthorized

## Changes

- **2026-07-09** `e95f3723e41f` — 5 breaking, 1 info
  - the `departureDate` request property type changed from `string` to `date`, and format from `date` to no format
  - the `productIds/items/` request property type changed from `string` to `array`
  - the `products/items/` request property type changed from `string` to `array`
  - the `returnDate` request property type changed from `string` to `date`, and format from `date` to no format
  - …2 more

[Change history](https://skmtc.dev/withfaye/apis/faye-partner-sales-api/changes/v2/quote/multi/post.md)

---

[API](https://skmtc.dev/withfaye/apis/faye-partner-sales-api.md) · [All operations](https://skmtc.dev/withfaye/apis/faye-partner-sales-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withfaye/apis/faye-partner-sales-api/revisions/e95f3723e41f?raw)
