Socotra
API ReferenceQuotes API

Quotes API

ActionEndpoint
Fetch a QuoteGET/policy/{tenantLocator}/quotes/{locator}
Fetch All QuotesGET/policy/{tenantLocator}/quotes/list
Create a QuotePOST/policy/{tenantLocator}/quotes
Update a QuotePATCH/policy/{tenantLocator}/quotes/{locator}
Add Elements to a QuotePUT/policy/{tenantLocator}/quotes/{locator}/elements
Remove Elements from a QuoteDELETE/policy/{tenantLocator}/quotes/{locator}/elements
Validate a QuotePATCH/policy/{tenantLocator}/quotes/{locator}/validate
Get a stateless validation preview for a hypothetical quotePOST/policy/{tenantLocator}/quotes/validatePreview
Price a QuotePATCH/policy/{tenantLocator}/quotes/{locator}/price
Fetch Quote PricingGET/policy/{tenantLocator}/quotes/{locator}/price
Get a stateless price preview for a hypothetical quotePOST/policy/{tenantLocator}/quotes/pricePreview
Underwrite a QuotePATCH/policy/{tenantLocator}/quotes/{locator}/underwrite
Fetch Underwriting FlagsGET/policy/{tenantLocator}/quotes/{locator}/underwritingFlags
Update a Quote's Underwriting FlagsPATCH/policy/{tenantLocator}/quotes/{locator}/underwritingFlags
Add Approve Level Underwriting Flag for QuotePOST/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/approve
Add Decline Level Underwriting Flag for QuotePOST/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/decline
Add Block Level Underwriting Flag for QuotePOST/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/block
Add Reject Level Underwriting Flag for QuotePOST/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/reject
Add Info Level Underwriting Flag for QuotePOST/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/info
Clear Approve Level Underwriting Flag for QuoteDELETE/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/approve/{flagLocator}
Clear Decline Level Underwriting Flag for QuoteDELETE/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/decline/{flagLocator}
Clear Block Level Underwriting Flag for QuoteDELETE/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/block/{flagLocator}
Clear Reject Level Underwriting Flag for QuoteDELETE/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/reject/{flagLocator}
Clear Info Level Underwriting Flag for QuoteDELETE/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/info/{flagLocator}
Accept a QuotePATCH/policy/{tenantLocator}/quotes/{locator}/accept
Issue a QuotePATCH/policy/{tenantLocator}/quotes/{locator}/issue
Copy a QuotePOST/policy/{tenantLocator}/quotes/{locator}/copy
Create Quote GroupPOST/policy/{tenantLocator}/quotes/groups
Fetch Quote GroupGET/policy/{tenantLocator}/quotes/groups/{locator}
Fetch All Quotes In GroupGET/policy/{tenantLocator}/quotes/groups/{locator}/list
Fetch Quote Group By NameGET/policy/{tenantLocator}/quotes/groups/name/{name}
Fetch Quote Groups In ATenantGET/policy/{tenantLocator}/quotes/groups/list
Update Quote GroupPATCH/policy/{tenantLocator}/quotes/groups/{locator}
Validate Quote GroupPATCH/policy/{tenantLocator}/quotes/groups/{locator}/validate
Delete Quote GroupDELETE/policy/{tenantLocator}/quotes/groups/{locator}
Assign Quote GroupPATCH/policy/{tenantLocator}/quotes/{locator}/assignToGroup
Add Static Data to a QuotePOST/policy/{tenantLocator}/quotes/{locator}/static
Update Static Data on a QuotePATCH/policy/{tenantLocator}/quotes/{locator}/static
Replace All Static Data on a QuotePUT/policy/{tenantLocator}/quotes/{locator}/static
Fetch Static Data for a QuoteGET/policy/{tenantLocator}/quotes/{locator}/static
List Static Data for a QuoteGET/policy/{tenantLocator}/quotes/{locator}/static/history/list
Update Billing Level For AQuotePATCH/policy/{tenantLocator}/quotes/{locator}/billingLevel
Add quote contactPOST/policy/{tenantLocator}/quotes/{quoteLocator}/contacts
Delete quote contactDELETE/policy/{tenantLocator}/quotes/{quoteLocator}/contacts/{contactLocator}
Fetch quote contactsGET/policy/{tenantLocator}/quotes/{quoteLocator}/contacts
Update quote contactPATCH/policy/{tenantLocator}/quotes/{quoteLocator}/contacts/{contactLocator}
Fetch Quotes With NumberGET/policy/{tenantLocator}/quotes/numbers/{quoteNumber}
Set Quote NumberPOST/policy/{tenantLocator}/quotes/{locator}/number/set
Generate Quote NumberPOST/policy/{tenantLocator}/quotes/{locator}/number/generate
Reset a QuotePATCH/policy/{tenantLocator}/quotes/{locator}/reset
Refuse a Quote (Insured Declined Coverage)PATCH/policy/{tenantLocator}/quotes/{locator}/refuse
Discard a QuotePATCH/policy/{tenantLocator}/quotes/{locator}/discard
Invoke the precommit plugin for a draft quotePATCH/policy/{tenantLocator}/quotes/{locator}/precommit

Main Flow

Fetch

Fetch a Quote

Fetch a QuotefetchQuote
GET/policy/{tenantLocator}/quotes/{locator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permission:
read

Fetch All Quotes

Fetch All QuotesfetchQuotesInATenant
GET/policy/{tenantLocator}/quotes/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
offsetqueryinteger?No
countqueryinteger?No
extendedqueryboolean?NoWhen false, returns a bare array.
Security Group:quotes
Permissions:
read,list

Fetch All Quotes for an Account

Fetch All Quotes for an AccountfetchQuotesForAccount
GET/policy/{tenantLocator}/accounts/{locator}/quotes/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
offsetqueryinteger?No
countqueryinteger?No
includeStaticDataqueryboolean?No
extendedqueryboolean?NoWhen false, returns a bare array.
Security Group:accounts
Permissions:
read,list
QuoteListResponse

Required properties

PropertyTypeDescription
listCompletedboolean
itemsQuoteResponse[]
QuoteResponse

Required properties

PropertyTypeDescription
locatorulid
accountLocatorulid
productNamestring
quoteStateEnum draft | validated | earlyUnderwritten | priced | underwritten | accepted | issued | underwrittenBlocked | declined | rejected | refused | discarded
billingLevelEnum account | inherit | policy
elementElementResponseThe root element in the hierarchy
contactsContactRoles[]

Optional properties

PropertyTypeDescription
policyLocatorulid?
groupLocatorulid?
quickQuoteLocatorulid?
regionstring?
autoRenewalPlanNamestring?
delinquencyPlanNamestring?
issuedTimedatetime?
startTimedatetime?
endTimedatetime?
acceptedTimedatetime?
currencystring?
durationnumber?The duration of the prospective policy in units of durationBasis
durationBasisEnum? years | months | weeks | days | hours
timezonestring?
anonymizedAtdatetime?
expirationTimedatetime?
invoiceFeeAmountnumber?
jurisdictionstring?
policyNumberstring?
preferencesPreferencesResponse?Plan selections and setting overrides
producerCodestring?
quoteNumberstring?
reservedPolicyNumberstring?
underwritingStatusstring?
validationResultValidationResult?
staticmap<string, object>?
createdAtdatetime?
createdByuuid?

The properties accountLocator, productName, startTime, endTime, duration, durationBasis, currency, element, and timezone will all be non-null for quotes that have been validated.

ElementResponse

Required properties

PropertyTypeDescription
locatorulid
staticLocatorulid
parentLocatorulid
originalEffectiveTimedatetimeIndicates when the element was first added to the policy
typestring

Optional properties

PropertyTypeDescription
categoryEnum? product | coverage | exposure | exposureGroup | policyLine
datamap<string, object>?
coverageTermsmap<string, object>?
elementsElementResponse[]?
PreferencesResponse

Properties

PropertyTypeDescription
installmentPreferencesInstallmentPreferences?
InstallmentPreferences

Required properties

PropertyTypeDescription
installmentWeightsnumber[]

Optional properties

PropertyTypeDescription
installmentPlanNamestring?
anchorModeEnum? generateDay | termStartDay | dueDay
anchorTimedatetime?
anchorTypeEnum? none | dayOfMonth | anchorTime | dayOfWeek | weekOfMonth
autopayLeadDaysnumber?
cadenceEnum? none | fullPay | weekly | everyOtherWeek | monthly | quarterly | semiannually | annually | thirtyDays | everyNDays
dayOfMonthinteger?
dayOfWeekEnum? monday | tuesday | wednesday | thursday | friday | saturday | sunday
dueLeadDaysinteger?
generateLeadDaysinteger?
maxInstallmentsPerTerminteger?
weekOfMonthEnum? none | first | second | third | fourth | fifth

Quote Creation

Create a Quote

Create a QuotecreateQuote
POST/policy/{tenantLocator}/quotes

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
Response:QuoteResponse
Security Group:quotes
Permissions:
write,create
QuoteCreateRequest

Required properties

PropertyTypeDescription
accountLocatorulid
productNamestring
startTimedatetime
invoiceFeeAmountnumber
datamap<string, object>
contactsContactRoles[]

Optional properties

PropertyTypeDescription
quoteGroupLocatorulid?
regionstring?
autoRenewalPlanNamestring?
delinquencyPlanNamestring?
endTimedatetime?
currencystring?
durationBasisEnum? years | months | weeks | days | hours
timezonestring?
billingLevelEnum? account | inherit | policy
expirationTimedatetime?
jurisdictionstring?
preferencesPreferencesResponse?
producerCodestring?
termDurationinteger?
staticmap<string, object>?
coverageTermsmap<string, object>?
elementsElementCreateRequest[]?
ElementCreateRequest

Required properties

PropertyTypeDescription
typestring

Optional properties

PropertyTypeDescription
staticLocatorulid?
parentLocatorulid?
datamap<string, object>?
coverageTermsmap<string, object>?
elementsElementCreateRequest[]?

Update

Update a Quote

Update a QuoteupdateQuote
PATCH/policy/{tenantLocator}/quotes/{locator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permissions:
write,update
QuoteUpdateRequest

Required properties

PropertyTypeDescription
accountLocatorulid
autoRenewalPlanNamestring
delinquencyPlanNamestring
startTimedatetime
endTimedatetime
currencystring
timezonestring
billingLevelEnum account | inherit | policy
expirationTimedatetime
invoiceFeeAmountnumber
preferencesPreferencesResponse
resetEndTimeboolean
elementsElementUpdateRequest[]
removeContactsulid[]
removeCoverageTermsmap<string, object>
removeDatamap<string, object>
setContactsContactRoles[]
setCoverageTermsmap<string, object>
setDatamap<string, object>

Optional properties

PropertyTypeDescription
jurisdictionstring?
producerCodestring?
ElementUpdateRequest

Required properties

PropertyTypeDescription
locatorulid
removeCoverageTermsmap<string, object>
removeDatamap<string, object>
setCoverageTermsmap<string, object>
setDatamap<string, object>

Add Elements to a Quote

Add Elements to a QuoteaddElementsToQuote
PUT/policy/{tenantLocator}/quotes/{locator}/elements

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permissions:
write,elements-add

Remove Elements from a Quote

Remove Elements from a QuoteremoveElementsFromQuote
DELETE/policy/{tenantLocator}/quotes/{locator}/elements

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Request:ulid[]
Response:QuoteResponse
Security Group:quotes
Permissions:
write,elements-delete

Validation

Validate a Quote

Validate a QuotevalidateQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/validate

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
statelessqueryboolean?No
Response:QuoteResponse
Security Group:quotes
Permissions:
write,validate
ValidationResult

Required properties

PropertyTypeDescription
successboolean

Optional properties

PropertyTypeDescription
validationItemsValidationItemResponse[]?
ValidationItemResponse

Required properties

PropertyTypeDescription
locatorulid
elementTypestring
errorsstring[]

Get a stateless validation preview for a hypothetical quote

Get a stateless validation preview for a hypothetical quotequoteValidatePreview
POST/policy/{tenantLocator}/quotes/validatePreview

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
Response:QuoteResponse
Security Group:quotes
Permission:
read

Pricing

Price a Quote

Price a QuotepriceQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/price

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
statelessqueryboolean?No
Security Group:quotes
Permissions:
write,price

Fetch Quote Pricing

Fetch Quote PricingfetchPricedQuote
GET/policy/{tenantLocator}/quotes/{locator}/price

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permission:
read
QuotePriceResponse

Required properties

PropertyTypeDescription
accountLocatorulid
quoteLocatorulid
tenantLocatoruuid
productNamestring
startTimedatetime
endTimedatetime
durationnumber
durationBasisEnum years | months | weeks | days | hours
quoteStateEnum draft | validated | earlyUnderwritten | priced | underwritten | accepted | issued | underwrittenBlocked | declined | rejected | refused | discarded
itemsPolicyChargeResponse[]

Optional properties

PropertyTypeDescription
quoteNumberstring?
validationResultValidationResult?
ChargeResponse

Required properties

PropertyTypeDescription
locatorulid
accountLocatorulid
currencystring
amountnumber
chargeCategoryEnum none | premium | tax | fee | credit | invoiceFee | cededPremium | nonFinancial | surcharge
chargeInvoicingEnum scheduled | next | immediate
chargeTypestring

Optional properties

PropertyTypeDescription
policyLocatorulid?
transactionLocatorulid?
bundleTransactionLocatorulid?
elementLocatorulid?
elementStaticLocatorulid?
reversalOfLocatorulid?
tagstring?

Get a stateless price preview for a hypothetical quote

Get a stateless price preview for a hypothetical quotequotePricePreview
POST/policy/{tenantLocator}/quotes/pricePreview

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
Security Group:quotes
Permission:
read

Underwriting

Underwrite a Quote

Underwrite a QuoteunderwriteQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/underwrite

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
statelessqueryboolean?No
Security Group:quotes
Permissions:
write,underwrite
QuoteUnderwritingResponse

Required properties

PropertyTypeDescription
accountLocatorulid
quoteLocatorulid
tenantLocatoruuid
productNamestring
startTimedatetime
endTimedatetime
durationnumber
durationBasisEnum years | months | weeks | days | hours
quoteStateEnum draft | validated | earlyUnderwritten | priced | underwritten | accepted | issued | underwrittenBlocked | declined | rejected | refused | discarded
underwritingStatusstring
underwritingFlagsUnderwritingFlagResponse[]

Optional properties

PropertyTypeDescription
validationResultValidationResult?

Underwriting Flags

Fetch Underwriting Flags

Fetch Underwriting FlagsfetchUnderwritingFlagsForQuote
GET/policy/{tenantLocator}/quotes/{locator}/underwritingFlags

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permission:
read
QuoteUnderwritingFlagsResponse

Required properties

PropertyTypeDescription
quoteLocatorulid
flagsUnderwritingFlagResponse[]

Optional properties

PropertyTypeDescription
clearedFlagsUnderwritingFlagResponse[]?
UnderwritingFlagResponse

Required properties

PropertyTypeDescription
locatorulid
referenceLocatorulid
clearedByuuid
clearedTimedatetime
createdTimedatetime
levelEnum info | block | decline | reject | approve
notestring
referenceTypeEnum quote | transaction
tagstring
taskCreationResponseTaskCreationResponse
createdByuuid

Optional properties

PropertyTypeDescription
elementLocatorulid?

Update a Quote's Underwriting Flags

Update a Quote's Underwriting FlagsupdateUnderwritingFlagsForQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/underwritingFlags

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permission:
write
UnderwritingFlagsUpdateRequest

Required properties

PropertyTypeDescription
addFlagsUnderwritingFlagCreateRequest[]
clearFlagsulid[]
UnderwritingFlagCreateRequest

Required properties

PropertyTypeDescription
elementLocatorulid
levelEnum info | block | decline | reject | approve
notestring
tagstring
taskCreationUnderwritingTaskCreateRequest
UnderwritingTaskCreateRequest

Required properties

PropertyTypeDescription
typestring
referencesTaskReference[]
underwritingFlagLocatorsulid[]

Optional properties

PropertyTypeDescription
workgroupToBeAssignedLocatorulid?
assignedTouuid?
deadlineTimedatetime?
descriptionstring?
sourcestring?
tagstring?

Add Approve Level Underwriting Flag for Quote

Add Approve Level Underwriting Flag for QuoteaddUnderwritingApproveFlagForQuote
POST/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/approve

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permissions:
write,approve-add

Add Decline Level Underwriting Flag for Quote

Add Decline Level Underwriting Flag for QuoteaddUnderwritingDeclineFlagForQuote
POST/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/decline

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permissions:
write,decline-add

Add Block Level Underwriting Flag for Quote

Add Block Level Underwriting Flag for QuoteaddUnderwritingBlockFlagForQuote
POST/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/block

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permissions:
write,block-add

Add Reject Level Underwriting Flag for Quote

Add Reject Level Underwriting Flag for QuoteaddUnderwritingRejectFlagForQuote
POST/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/reject

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permissions:
write,reject-add

Add Info Level Underwriting Flag for Quote

Add Info Level Underwriting Flag for QuoteaddUnderwritingInfoFlagForQuote
POST/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/info

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permissions:
write,info-add

Clear Approve Level Underwriting Flag for Quote

Clear Approve Level Underwriting Flag for QuoteclearUnderwritingApproveFlagForQuote
DELETE/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/approve/{flagLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
flagLocatorpathulidYes
Security Group:quotes
Permissions:
write,approve-clear

Clear Decline Level Underwriting Flag for Quote

Clear Decline Level Underwriting Flag for QuoteclearUnderwritingDeclineFlagForQuote
DELETE/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/decline/{flagLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
flagLocatorpathulidYes
Security Group:quotes
Permissions:
write,decline-clear

Clear Block Level Underwriting Flag for Quote

Clear Block Level Underwriting Flag for QuoteclearUnderwritingBlockFlagForQuote
DELETE/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/block/{flagLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
flagLocatorpathulidYes
Security Group:quotes
Permissions:
write,block-clear

Clear Reject Level Underwriting Flag for Quote

Clear Reject Level Underwriting Flag for QuoteclearUnderwritingRejectFlagForQuote
DELETE/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/reject/{flagLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
flagLocatorpathulidYes
Security Group:quotes
Permissions:
write,reject-clear

Clear Info Level Underwriting Flag for Quote

Clear Info Level Underwriting Flag for QuoteclearUnderwritingInfoFlagForQuote
DELETE/policy/{tenantLocator}/quotes/{locator}/underwritingFlags/info/{flagLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
flagLocatorpathulidYes
Security Group:quotes
Permissions:
write,info-clear

Acceptance

Accept a Quote

Accept a QuoteacceptQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/accept

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permissions:
write,accept

Issuance

Issue a Quote

Issue a QuoteissueQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/issue

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permissions:
write,issue

Copying

Copy a Quote

Copy a QuotecopyQuote
POST/policy/{tenantLocator}/quotes/{locator}/copy

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permissions:
write,create

Create Quote From Policy

Create Quote From PolicycreateQuoteFromPolicy
POST/policy/{tenantLocator}/policies/{locator}/quote

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
datequerydatetime?No
byIssuedTimequeryboolean?No
includeStaticDataqueryboolean?No
Response:QuoteResponse
Security Group:policies
Permissions:
write,create-quote

Quote Groups

Create Quote Group

Create Quote GroupcreateQuoteGroup
POST/policy/{tenantLocator}/quotes/groups

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
Security Group:quotes
Permission:
write
QuoteGroupCreateRequest

Required properties

PropertyTypeDescription
preferredQuoteLocatorulid
namestring
quoteGroupNumberstring
settingsQuoteGroupSettings
quoteLocatorsulid[]
QuoteGroupSettings

Required properties

PropertyTypeDescription
enforceProductUniformitybooleandefault: false
stateUniquenessEnum draft | validated | earlyUnderwritten | priced | underwritten | accepted | issued | underwrittenBlocked | declined | rejected | refused | discarded
fieldEnforcementDeclarationsQuoteGroupFieldEnforcementDeclaration[]
QuoteGroupFieldEnforcementDeclaration

Required properties

PropertyTypeDescription
namestring
pathsmap<string, string>
QuoteGroupResponse

Required properties

PropertyTypeDescription
locatorulid
namestring
quoteGroupStateEnum open | locked
settingsQuoteGroupSettings
createdAtdatetime
createdByuuid
quoteLocatorsulid[]

Optional properties

PropertyTypeDescription
preferredQuoteLocatorulid?
quoteGroupNumberstring?

Fetch Quote Group

Fetch Quote GroupfetchQuoteGroup
GET/policy/{tenantLocator}/quotes/groups/{locator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permission:
read

Fetch All Quotes In Group

Fetch All Quotes In GroupfetchAllQuotesInGroup
GET/policy/{tenantLocator}/quotes/groups/{locator}/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
offsetqueryinteger?No
countqueryinteger?No
Security Group:quotes
Permissions:
read,list
ListPageResponseQuote

Required properties

PropertyTypeDescription
listCompletedboolean
itemsQuickQuoteQuoteDetails[]

Fetch Quote Group By Name

Fetch Quote Group By NamefetchQuoteGroupByName
GET/policy/{tenantLocator}/quotes/groups/name/{name}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namepathstringYes
Security Group:quotes
Permission:
read

Fetch Quote Groups In ATenant

Fetch Quote Groups In A TenantfetchQuoteGroupsInATenant
GET/policy/{tenantLocator}/quotes/groups/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
offsetqueryinteger?No
countqueryinteger?No
Security Group:quotes
Permissions:
read,list
ListPageResponseQuoteGroup

Required properties

PropertyTypeDescription
listCompletedboolean
itemsQuoteGroupResponse[]

Update Quote Group

Update Quote GroupupdateQuoteGroup
PATCH/policy/{tenantLocator}/quotes/groups/{locator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permission:
write
QuoteGroupUpdateRequest

Required properties

PropertyTypeDescription
preferredQuoteLocatorulid
namestring
quoteGroupNumberstring
resetPreferredQuoteboolean
quotesToAddulid[]
quotesToRemoveulid[]

Validate Quote Group

Validate Quote GroupvalidateQuoteGroup
PATCH/policy/{tenantLocator}/quotes/groups/{locator}/validate

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:quotes
Permissions:
write,validate
QuoteGroupValidationResponse

Required properties

PropertyTypeDescription
validboolean
errorsstring[]

Delete Quote Group

Delete Quote GroupdeleteQuoteGroup
DELETE/policy/{tenantLocator}/quotes/groups/{locator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:void
Security Group:quotes
Permission:
write

Assign Quote Group

Assign Quote GroupassignQuoteGroup
PATCH/policy/{tenantLocator}/quotes/{locator}/assignToGroup

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permission:
write
QuoteGroupAssignmentRequest

Required properties

PropertyTypeDescription
groupLocatorulid

Static Data

Add Static Data to a Quote

Add Static Data to a QuoteaddStaticDataForQuote
POST/policy/{tenantLocator}/quotes/{locator}/static

Set the static extension data on a quote

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Request:map<string, object>
Response:QuoteResponse
Security Group:quotes
Permissions:
write,static-data-add

Update Static Data on a Quote

Update Static Data on a QuoteupdateStaticDataForQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/static

Updates some of the static data on a quote

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permissions:
write,static-data-update
StaticDataUpdateRequest

Required properties

PropertyTypeDescription
removeDatamap<string, object>
setDatamap<string, object>

Replace All Static Data on a Quote

Replace All Static Data on a QuotereplaceAllStaticDataForQuote
PUT/policy/{tenantLocator}/quotes/{locator}/static

Replaces all of the static data on a quote

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Request:map<string, object>
Response:QuoteResponse
Security Group:quotes
Permissions:
write,static-data-add

Fetch Static Data for a Quote

Fetch Static Data for a QuotefetchStaticDataForQuote
GET/policy/{tenantLocator}/quotes/{locator}/static

Gets static data for a quote

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:map<string, object>
Security Group:quotes
Permission:
read

List Static Data for a Quote

List Static Data for a QuotelistStaticDataForQuote
GET/policy/{tenantLocator}/quotes/{locator}/static/history/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
offsetqueryinteger?No
countqueryinteger?No
Security Group:quotes
Permission:
read
ListPageResponseStaticDataHistoryResponse

Required properties

PropertyTypeDescription
listCompletedboolean
itemsStaticDataHistoryResponse[]
StaticDataHistoryResponse

Required properties

PropertyTypeDescription
historyLocatorulid
updatedAtdatetime
updatedByuuid
staticDatamap<string, object>

Documents

Fetch Documents for a Quote

Fetch Documents for a QuotefetchDocumentsForQuote
GET/document/{tenantLocator}/documents/quote/{locator}/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
offsetqueryinteger?No
countqueryinteger?No
extendedqueryboolean?NoWhen false, returns a bare array.
suppressRenderingDataqueryboolean?No
Security Group:documents
Permission:
read
DocumentInstanceResponse

Required properties

PropertyTypeDescription
locatorulid
referenceLocatorulid
documentInstanceStateEnum draft | dataReady | ready | dataError | renderError | conversionError | rendered
documentFormatEnum csv | doc | docx | html | jpeg | jpg | pdf | text | txt | xls | xlsx | zip
externalboolean
referenceTypeEnum quote | policy | invoice | transaction | segment | term
createdAtdatetime
consolidatedFromulid[]
consolidatedToulid[]
metadatamap<string, object>
renderingDatamap<string, object>

Optional properties

PropertyTypeDescription
policyLocatorulid?
termLocatorulid?
transactionLocatorulid?
segmentLocatorulid?
referenceDocumentLocatorulid?
staticNamestring?
namestring?
categorystring?
copyOnIssuanceboolean?
processingErrorsstring?
readyAtdatetime?
createdByuuid?

Billing

Update Billing Level For AQuote

Update Billing Level For A QuoteupdateBillingLevelForAQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/billingLevel

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permission:
write
UpdateBillingLevelRequest

Required properties

PropertyTypeDescription
billingLevelEnum account | inherit | policy

Update the Delinquency Plan Assigned to a Quote

Update the Delinquency Plan Assigned to a QuoteupdateQuoteDelinquencyPlan
PATCH/policy/{tenantLocator}/quotes/{locator}/delinquencyPlan

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permission:
write

Contacts

Add quote contact

Add quote contactaddQuoteContact
POST/policy/{tenantLocator}/quotes/{quoteLocator}/contacts

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
quoteLocatorpathulidYes
Request:ContactRoles
Response:QuoteResponse
Security Group:quotes
Permission:
write
ContactRoles

Required properties

PropertyTypeDescription
contactLocatorulid
rolesstring[]

Delete quote contact

Delete quote contactdeleteQuoteContact
DELETE/policy/{tenantLocator}/quotes/{quoteLocator}/contacts/{contactLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
quoteLocatorpathulidYes
contactLocatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permission:
write

Fetch quote contacts

Fetch quote contactsfetchQuoteContacts
GET/policy/{tenantLocator}/quotes/{quoteLocator}/contacts

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
quoteLocatorpathulidYes
Response:ContactRoles[]
Security Group:quotes
Permission:
write

Update quote contact

Update quote contactupdateQuoteContact
PATCH/policy/{tenantLocator}/quotes/{quoteLocator}/contacts/{contactLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
quoteLocatorpathulidYes
contactLocatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permission:
write

Numbering

Fetch Quotes With Number

Fetch Quotes With NumberfetchQuotesWithNumber
GET/policy/{tenantLocator}/quotes/numbers/{quoteNumber}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
quoteNumberpathstringYes
Response:QuoteResponse[]
Security Group:quotes
Permissions:
read,list

Set Quote Number

Set Quote NumbersetQuoteNumber
POST/policy/{tenantLocator}/quotes/{locator}/number/set

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
quoteNumberquerystringYes
Response:QuoteResponse
Security Group:quotes
Permission:
write

Generate Quote Number

Generate Quote NumbergenerateQuoteNumber
POST/policy/{tenantLocator}/quotes/{locator}/number/generate

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permission:
write

Holds

Fetch Quote Holds

Fetch Quote HoldsfetchQuoteHolds
GET/policy/{tenantLocator}/quotes/{locator}/holds

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:EntityHold[]
Security Group:quotes
Permission:
read

Atypical States and Operations

Reset a Quote

Reset a QuoteresetQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/reset

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Request:ResetOptions
Response:QuoteResponse
Security Group:quotes
Permissions:
write,reset
ResetOptions

Required properties

PropertyTypeDescription
deleteAllAutomaticDocumentsboolean
discardSchedulesboolean
resetAllUnderwritingFlagsboolean
resetFlagsActionEnum clear | delete
deleteDocumentsulid[]
resetFlagsulid[]

Refuse a Quote (Insured Declined Coverage)

Refuse a Quote (Insured Declined Coverage)refuseQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/refuse

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permissions:
write,refuse

Discard a Quote

Discard a QuotediscardQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/discard

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permissions:
write,discard

Invoke the precommit plugin for a draft quote

Invoke the precommit plugin for a draft quoteprecommitQuote
PATCH/policy/{tenantLocator}/quotes/{locator}/precommit

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:QuoteResponse
Security Group:quotes
Permissions:
write,precommit

On this page

Main Flow
Fetch
Fetch a Quote
Fetch All Quotes
Fetch All Quotes for an Account
Quote Creation
Create a Quote
Update
Update a Quote
Add Elements to a Quote
Remove Elements from a Quote
Validation
Validate a Quote
Get a stateless validation preview for a hypothetical quote
Pricing
Price a Quote
Fetch Quote Pricing
Get a stateless price preview for a hypothetical quote
Underwriting
Underwrite a Quote
Underwriting Flags
Fetch Underwriting Flags
Update a Quote's Underwriting Flags
Add Approve Level Underwriting Flag for Quote
Add Decline Level Underwriting Flag for Quote
Add Block Level Underwriting Flag for Quote
Add Reject Level Underwriting Flag for Quote
Add Info Level Underwriting Flag for Quote
Clear Approve Level Underwriting Flag for Quote
Clear Decline Level Underwriting Flag for Quote
Clear Block Level Underwriting Flag for Quote
Clear Reject Level Underwriting Flag for Quote
Clear Info Level Underwriting Flag for Quote
Acceptance
Accept a Quote
Issuance
Issue a Quote
Copying
Copy a Quote
Create Quote From Policy
Quote Groups
Create Quote Group
Fetch Quote Group
Fetch All Quotes In Group
Fetch Quote Group By Name
Fetch Quote Groups In ATenant
Update Quote Group
Validate Quote Group
Delete Quote Group
Assign Quote Group
Static Data
Add Static Data to a Quote
Update Static Data on a Quote
Replace All Static Data on a Quote
Fetch Static Data for a Quote
List Static Data for a Quote
Documents
Fetch Documents for a Quote
Billing
Update Billing Level For AQuote
Update the Delinquency Plan Assigned to a Quote
Contacts
Add quote contact
Delete quote contact
Fetch quote contacts
Update quote contact
Numbering
Fetch Quotes With Number
Set Quote Number
Generate Quote Number
Holds
Fetch Quote Holds
Atypical States and Operations
Reset a Quote
Refuse a Quote (Insured Declined Coverage)
Discard a Quote
Invoke the precommit plugin for a draft quote