The GET_QUOTES event is used to request insurance quotes for a product. When triggered, the system orchestrates multiple rating actions (such as IOI_RATING, VERISK, VERISK_ALGO, or BUNDLE_RATING) based on the product configuration and returns calculated premiums, coverages, taxes, and fees.
Key behaviors:
Automatically creates or updates a client record with the provided intake data (unless batchMode: true)
Supports both synchronous and asynchronous response modes via the forceSync parameter
Can execute multiple rating actions in parallel and aggregate results
Returns quotes with detailed premium breakdowns, coverage information, and any applicable messages
When and what fires this event?
If this event is defined on a product, and it has actions that are enabled:
CoPilot: fires this event when a new quote is requested in the Account Builder
Storefront: fires this event at the end of client intake
If true, skips the automatic CREATE_OR_UPDATE_CLIENT action. Default: false.
batchId
string (UUID)
No
Identifier for batch processing operations.
filterByOrganizations
array
No
Array of organization UUIDs. Limits which rating actions are executed based on organization ownership.
eventTargets
array
No
Array of action/event UUIDs. Limits execution to only the specified actions.
source
object
Yes
Information about the request source. See source Object.
agencyCodes
array
No
Array of agency code configurations for carrier-specific routing. See agencyCodes Array.
payload
object
Yes
The quote request data including client information and intake answers. See payload Object.
Understanding forceSync
The forceSync parameter is critical for determining how the API responds to your request. It controls whether the system waits for all rating actions to complete before returning.
When forceSync: true (Synchronous Mode)
The API waits for all rating actions to complete and returns the quotes directly in the response.
Response behavior:
The API call blocks until all configured rating actions finish
The metadata.quotes array contains all generated quotes
Longer response time (depends on number and complexity of rating actions)
Number of actions that will produce quote responses.
metadata
object
Contains action results.
Metadata Object
Field
Type
Description
CREATE_OR_UPDATE_CLIENT
object
Result from the client creation/update action.
quotes
array
List of generated quotes. Only present when forceSync: true.
CREATE_OR_UPDATE_CLIENT Object
Field
Type
Description
clientId
string (UUID)
The created or updated client ID.
intake
object
The intake data associated with the client.
quote Object
Field
Type
Description
id
string (UUID)
Unique quote identifier.
actionId
string (UUID)
The action that generated this quote.
actionType
string
The type of rating action. Values: IOI_RATING, VERISK, VERISK_ALGO, BUNDLE_RATING.
type
string
The quote result type. Values: QUOTE, DECLINE, BATCH, INDICATION.
lineId
string (UUID)
Product/Line identifier.
clientId
string (UUID)
Client identifier.
pipelineId
string (UUID)
Pipeline identifier.
quotingOrganizationId
string (UUID)
Organization that generated the quote.
clientOrganizationId
string (UUID)
Client's organization.
triggerRequestId
string (UUID)
Original trigger request ID.
requestId
string (UUID)
Individual action request ID.
effectiveDate
string (date)
Policy effective date. Format: YYYY-MM-DD.
term
number
Policy term in months.
bindable
boolean
Whether the quote can be bound to a policy.
requiresUnderwriterApproval
boolean
Whether underwriter approval is required.
requiresPolicyholderAcceptance
boolean
Whether policyholder acceptance is required.
quoteTimestamp
string (ISO 8601)
When the quote was generated.
quoteDetails
object
Premium, coverages, taxes, and fees breakdown.
messages
array
System and consumer-facing messages.
metadata
object
Additional quote metadata (varies by action type).
source
object
Source information.
productVersionId
string (UUID)
Product version used for rating.
versionSystemSource
string
Version source system. Values: HOSTING, BUILDER, null.
inputMappingData
object
The input data used for rating calculation.
The actionType field should always be used by consumers to determine how to parse and interpret the quote response,especially the contents of the metadata object.
quoteDetails Object
Field
Type
Description
premium
object
Premium information.
coverages
array
List of coverage details.
taxes
object
Tax breakdown.
fees
object
Fee breakdown.
premium Object
Field
Type
Description
amount
number
The premium amount. A value of -1 indicates a declined quote.
currency
string
Currency code (e.g., USD).
coverages Array Item
Field
Type
Description
name
string
Coverage name.
code
string
Coverage code.
premium
number
Coverage premium amount.
limit
number
Coverage limit.
deductible
number
Coverage deductible.
taxes Object
Field
Type
Description
amount
number
Total tax amount.
details
array
Breakdown of individual taxes.
taxes.details Array Item
Field
Type
Description
name
string
Tax name.
amount
number
Tax amount.
rate
number
Tax rate (decimal).
fees Object
Field
Type
Description
amount
number
Total fee amount.
details
array
Breakdown of individual fees.
fees.details Array Item
Field
Type
Description
name
string
Fee name.
amount
number
Fee amount.
messages Array Item
Field
Type
Description
message
string
The message text.
type
string
Message type. Values: SYSTEM, CONSUMER, ERROR.
Enum Values Reference
sourceType Values
Value
Description
STOREFRONT
Request from a storefront application. Requires a valid storefrontId in the source object.
INTERNAL_CALL
Internal service-to-service call.
API
External API request.
BATCH
Batch processing request.
versionSystemSource Values
Value
Description
HOSTING
Use the deployed version from the hosting service (production configuration).
BUILDER
Use the version from product builder (useful for testing unpublished changes).
null
Use top-of-tree configuration (latest).
requestSource Values
Value
Description
QUOTE
New quote request. This is the default.
RENEWAL
Renewal quote request for an existing policy.
ISSUANCE
Policy issuance request.
ENDORSEMENT
Policy endorsement/modification request.
PACKAGE_RATER
Package/bundle rating request.
TRUE_UP
True-up adjustment request.
actionType Values
Value
Description
IOI_RATING
DAIS internal rating engine (Excel, Node, Java, or Origami-based).
VERISK
Verisk RaaS (Rating as a Service) integration.
VERISK_ALGO
Hybrid rating combining Verisk RaaS with local Excel algorithm.
BUNDLE_RATING
Bundled/package rating that aggregates multiple coverages into one quote.
The following examples show quote responses produced by different rating actions. Each example corresponds to a specific actionType.
GET_QUOTES may trigger multiple rating actions depending on the product configuration. Each rating action produces a separate quote response, which can be identified by the actionType field.
While the overall quote structure is consistent across responses, some fields and metadata vary depending on the action type. Consumers should always rely on actionType to understand how to interpret the quote metadata.
Note: executedActionCount (6) includes all actions (CREATE_OR_UPDATE_CLIENT + 4 rating actions + non-quote actions like WEBHOOK/EMAIL), but expectedResponseCount (4) only counts actions that produce quotes.