Policy Transactions API

Endpoint Index

Action	Endpoint
Fetch a Transaction	GET /policy/{tenantLocator}/transactions/{locator}
Fetch Policy Transaction with Updated Changes	GET /policy/{tenantLocator}/transactions/{locator}/elements/changes
Fetch Transaction Branches by Policy	GET /policy/{tenantLocator}/policies/{locator}/branches
Fetch Policy Segment for a Transaction	GET /policy/{tenantLocator}/transactions/{locator}/segment
Fetch a Policy Segment	GET /policy/{tenantLocator}/transactions/segments/{segmentLocator}
Fetch Issued Transactions	GET /policy/{tenantLocator}/policies/{locator}/issuedTransactions/list
Create a Transaction	PATCH /policy/{tenantLocator}/policies/{locator}/{transactionType}
Create a Policy Change Transaction	PATCH /policy/{tenantLocator}/policies/{locator}/change
Create a Renewal Transaction	PATCH /policy/{tenantLocator}/policies/{locator}/renew
Create a Cancellation Transaction	PATCH /policy/{tenantLocator}/policies/{locator}/cancel
Create a Reinstatement Transaction	PATCH /policy/{tenantLocator}/policies/{locator}/reinstate
Create a Reversal Transaction	PATCH /policy/{tenantLocator}/policies/{locator}/reversal
Initialize Transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/initialize
Add Elements To Policy with Transaction	PUT /policy/{tenantLocator}/transactions/{locator}/elements
Update Elements In Policy with Transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/elements
Remove Elements From Policy with Transaction	DELETE /policy/{tenantLocator}/transactions/{locator}/elements
Add a Change Instruction to a Transaction	PUT /policy/{tenantLocator}/transactions/{locator}/changeInstructions
Update One of a Transaction's Change Instructions	PATCH /policy/{tenantLocator}/transactions/{locator}/changeInstructions/{instructionLocator}
Delete a Change Instruction from a Transaction	DELETE /policy/{tenantLocator}/transactions/{locator}/changeInstructions/{instructionLocator}
Validate a Transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/validate
Get a stateless validation preview for a hypothetical transaction	PATCH /policy/{tenantLocator}/policies/{locator}/{transactionType}/validatePreview
Price a Transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/price
Fetch Pricing for a Transaction	GET /policy/{tenantLocator}/transactions/{locator}/price
Get a stateless price preview for a hypothetical transaction	PATCH /policy/{tenantLocator}/policies/{locator}/{transactionType}/pricePreview
Underwrite a Transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/underwrite
Get a stateless underwriting preview for a hypothetical transaction	PATCH /policy/{tenantLocator}/policies/{locator}/{transactionType}/underwritePreview
Update a Transaction's Underwriting Flags	PATCH /policy/{tenantLocator}/transactions/{locator}/underwritingFlags
Fetch Underwriting Flags	GET /policy/{tenantLocator}/transactions/{locator}/underwritingFlags
Add Approve Level Underwriting Flag for Transaction	POST /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/approve
Add Decline Level Underwriting Flag for Transaction	POST /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/decline
Add Block Level Underwriting Flag for Transaction	POST /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/block
Add Reject Level Underwriting Flag for Transaction	POST /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/reject
Add Info Level Underwriting Flag for Transaction	POST /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/info
Clear Approve Level Underwriting Flag for Transaction	DELETE /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/approve/{flagLocator}
Clear Decline Level Underwriting Flag for Transaction	DELETE /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/decline/{flagLocator}
Clear Block Level Underwriting Flag for Transaction	DELETE /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/block/{flagLocator}
Clear Reject Level Underwriting Flag for Transaction	DELETE /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/reject/{flagLocator}
Clear Info Level Underwriting Flag for Transaction	DELETE /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/info/{flagLocator}
Accept a Transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/accept
Issue a Transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/issue
Fetch Preferences for a Transaction	GET /policy/{tenantLocator}/transactions/{locator}/preferences
Fetch Affected Transactions	GET /policy/{tenantLocator}/transactions/{locator}/affectedTransactions
Reset a Transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/reset
Refuse a Transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/refuse
Discard a Transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/discard
Invoke the precommit plugin for a draft or initialized transaction	PATCH /policy/{tenantLocator}/transactions/{locator}/precommit
Fetch Affected Transactions for List Endpoint	GET /policy/{tenantLocator}/transactions/{locator}/affectedTransactions/list
Fetch Transaction Segments	GET /policy/{tenantLocator}/transactions/{locator}/segments/list
Fetch Policy Segment Ex	GET /policy/{tenantLocator}/transactions/{locator}/segments/{segmentLocator}

Main Flow

Note

For unissued transactions that are elible for issuance, you can attempt to advance to any subsequent state. If the transaction fails to validate, the response will be HTTP 200, but the transaction itself will not be in the requested new state. The actual state of the transaction will be included in the payload.

Fetch

Fetch a Transaction

fetchTransaction

GET /policy/{tenantLocator}/transactions/{locator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:PolicyTransactionResponse
Security Group:transactions   Permission:read

PolicyTransactionResponse

required
locator string
staticLocator string
Equals the locator of the first transaction this is based on.
policyLocator string
termLocator string
effectiveTime datetime
transactionState Enum draft | initialized | validated | earlyUnderwritten | priced | underwritten | accepted | issued | underwrittenBlocked | declined | rejected | refused | discarded | invalidated | reversed
transactionCategory Enum issuance | change | renewal | cancellation | reinstatement | reversal | aggregate
transactionType string
createdAt datetime
createdBy uuid

optional
aggregateTransactionLocator string?
baseTransactionLocator string?
reapplicationOfLocator string?
issuedTime datetime?
acceptedTime datetime?
anonymizedAt datetime?
maskingLevel Enum? level1 | level2 | none
preferences PreferencesResponse?
underwritingStatus string?
validationResult ValidationResult?
aggregatedTransactions PolicyTransactionResponse[]?
changeInstructions oneOf<AddChangeInstructionResponse, ModifyChangeInstructionResponse, ParamsChangeInstructionResponse, DeleteChangeInstructionResponse>[]?
billingTrigger Enum? accept | issue (deprecated)

Note

The staticLocator of the transaction equals the locator for the original version of a transaction. When transactions are reapplied, as in out-of-sequence transactions, the staticLocator will equal the staticLocator of the transaction this it is based on.

PreferencesResponse

optional
billingPreferences BillingPreferences?
installmentPreferences InstallmentPreferences?

BillingPreferences

Deprecated

This entity will be removed in a future release.

optional
billingPlanName string?
billingLevel Enum? account | inherit | policy

InstallmentPreferences

required
installmentWeights number[]

optional
installmentPlanName string?
anchorMode Enum? generateDay | termStartDay | dueDay
anchorTime datetime?
anchorType Enum? none | dayOfMonth | anchorTime | dayOfWeek | weekOfMonth
autopayLeadDays number?
cadence Enum? none | fullPay | weekly | everyOtherWeek | monthly | quarterly | semiannually | annually | thirtyDays | everyNDays
dayOfMonth int?
dayOfWeek Enum? monday | tuesday | wednesday | thursday | friday | saturday | sunday
dueLeadDays int?
generateLeadDays int?
maxInstallmentsPerTerm int?
weekOfMonth Enum? none | first | second | third | fourth | fifth

Fetch Policy Transaction with Updated Changes

fetchPolicyTransactionWithUpdatedChanges

GET /policy/{tenantLocator}/transactions/{locator}/elements/changes

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:PolicyTransactionResponse
Security Group:transactions   Permission:read

Fetch Transaction Branches by Policy

getTransactionsBranchesByPolicy

GET /policy/{tenantLocator}/policies/{locator}/branches

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:map<string,PolicyTransactionResponse[]>
Security Group:policies   Permission:read

Fetch Policy Segment for a Transaction

fetchTransactionSegment

GET /policy/{tenantLocator}/transactions/{locator}/segment

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:SegmentResponse
Security Group:transactions   Permission:read

Fetch a Policy Segment

fetchPolicySegment

GET /policy/{tenantLocator}/transactions/segments/{segmentLocator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
segmentLocator	path	string	required

Response:SegmentResponse
Security Group:transactions   Permission:read

SegmentResponse

required
locator string
transactionLocator string
startTime datetime
endTime datetime
duration number
element ElementResponse
The root element in the hierarchy
segmentType Enum coverage | gap

optional
anonymizedAt datetime?
basedOn string?

ChangeInstructionResponse

required
action string

AddChangeInstructionResponse

required
locator locator
action Enum add
elements ElementCreateRequest[]

ModifyChangeInstructionResponse

required
locator locator
staticLocator string
action Enum modify
removeCoverageTerms map<string,object>
removeData map<string,object>
setCoverageTerms map<string,object>
setData map<string,object>

ParamsChangeInstructionResponse

required
locator locator
effectiveTime datetime
action Enum params

optional
newPolicyEndTime datetime?
preferences PreferencesResponse?
triggerBillingChange boolean?
billingModeChange boolean? (deprecated)
Use triggerBillingChange instead.
inheritSettings boolean? (deprecated)

DeleteChangeInstructionResponse

required
locator locator
action Enum delete
staticElementLocators string[]

Fetch Issued Transactions

fetchIssuedTransactions

Fetches the 'local stack' of issued transactions, excluding those that have been reversed or reapplied

GET /policy/{tenantLocator}/policies/{locator}/issuedTransactions/list

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
offset	query	int?	optional
count	query	int?	optional
extended	query	boolean?	optional

Response:PolicyTransactionListResponse
Security Group:policies   Permission:read

PolicyTransactionListResponse

required
listCompleted boolean
items PolicyTransactionResponse[]

Transaction Creation

Create a Transaction

createPolicyTransaction

PATCH /policy/{tenantLocator}/policies/{locator}/{transactionType}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
transactionType	path	string	required
baseLocator	query	string?	optional

Request:oneOf<AddChangeInstructionCreateRequest, DeleteChangeInstructionCreateRequest, ModifyChangeInstructionCreateRequest, ParamsChangeInstructionCreateRequest>[]
Response:PolicyTransactionResponse
Security Group:policies   Permission:write

Create a Policy Change Transaction

changePolicy

PATCH /policy/{tenantLocator}/policies/{locator}/change

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
baseLocator	query	string?	optional

Request:oneOf<AddChangeInstructionCreateRequest, DeleteChangeInstructionCreateRequest, ModifyChangeInstructionCreateRequest, ParamsChangeInstructionCreateRequest>[]
Response:PolicyTransactionResponse
Security Group:policies   Permission:write

Create a Renewal Transaction

renewPolicy

PATCH /policy/{tenantLocator}/policies/{locator}/renew

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
baseLocator	query	string?	optional

Request:oneOf<AddChangeInstructionCreateRequest, DeleteChangeInstructionCreateRequest, ModifyChangeInstructionCreateRequest, ParamsChangeInstructionCreateRequest>[]
Response:PolicyTransactionResponse
Security Group:policies   Permission:write

Create a Cancellation Transaction

cancelPolicy

PATCH /policy/{tenantLocator}/policies/{locator}/cancel

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
baseLocator	query	string?	optional

Request:ParamsChangeInstructionCreateRequest
Response:PolicyTransactionResponse
Security Group:policies   Permission:write

Create a Reinstatement Transaction

reinstatePolicy

PATCH /policy/{tenantLocator}/policies/{locator}/reinstate

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
baseLocator	query	string?	optional

Request:oneOf<AddChangeInstructionCreateRequest, DeleteChangeInstructionCreateRequest, ModifyChangeInstructionCreateRequest, ParamsChangeInstructionCreateRequest>[]
Response:PolicyTransactionResponse
Security Group:policies   Permission:write

AddChangeInstructionCreateRequest

required
action Enum add
elements ElementCreateRequest[]

ParamsChangeInstructionCreateRequest

required
effectiveTime datetime
action Enum params

optional
newPolicyEndTime datetime?
preferences PreferencesResponse?
triggerBillingChange boolean?
billingModeChange boolean? (deprecated)
Use triggerBillingChange instead.
inheritSettings boolean? (deprecated)

ModifyChangeInstructionCreateRequest

required
staticLocator string
action Enum modify
removeCoverageTerms map<string,object>
removeData map<string,object>
setCoverageTerms map<string,object>
setData map<string,object>

DeleteChangeInstructionCreateRequest

required
action Enum delete
staticElementLocators string[]

Create a Reversal Transaction

reversePolicyChange

PATCH /policy/{tenantLocator}/policies/{locator}/reversal

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:PolicyTransactionReversalRequest
Response:PolicyTransactionResponse
Security Group:policies   Permission:write

PolicyTransactionReversalRequest

required
baseLocator string
toTransaction string
reverseTransactions string[]

Updating

Initialize Transaction

initializeTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/initialize

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,initialize

Add Elements To Policy with Transaction

addElementsToPolicyWithTransaction

PUT /policy/{tenantLocator}/transactions/{locator}/elements

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:ElementCreateRequest[]
Response:SegmentResponse[]
Security Group:transactions   Permissions:write,elements-add

Update Elements In Policy with Transaction

updateElementsInPolicyWithTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/elements

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:ElementUpdateRequest
Response:SegmentResponse[]
Security Group:transactions   Permissions:write,elements-update

Remove Elements From Policy with Transaction

removeElementsFromPolicyWithTransaction

DELETE /policy/{tenantLocator}/transactions/{locator}/elements

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:string[]
Response:SegmentResponse[]
Security Group:transactions   Permissions:write,elements-delete

Add a Change Instruction to a Transaction

createPolicyChangeInstruction

PUT /policy/{tenantLocator}/transactions/{locator}/changeInstructions

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:oneOf<AddChangeInstructionCreateRequest, DeleteChangeInstructionCreateRequest, ModifyChangeInstructionCreateRequest, ParamsChangeInstructionCreateRequest>
Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,change-instruction-add

Update One of a Transaction's Change Instructions

updateChangeInstruction

PATCH /policy/{tenantLocator}/transactions/{locator}/changeInstructions/{instructionLocator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
instructionLocator	path	string	required

Request:oneOf<AddChangeInstructionCreateRequest, DeleteChangeInstructionCreateRequest, ModifyChangeInstructionCreateRequest, ParamsChangeInstructionCreateRequest>
Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,change-instruction-update

Delete a Change Instruction from a Transaction

deleteChangeInstructionFromTransaction

DELETE /policy/{tenantLocator}/transactions/{locator}/changeInstructions/{instructionLocator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
instructionLocator	path	string	required

Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,change-instruction-delete

Note

Transactions can only be updated when they are in draft state.

Validation

Validate a Transaction

validateTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/validate

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
stateless	query	boolean?	optional

Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,validate

ValidationResult

required
success boolean

optional
validationItems ValidationItemResponse[]?

ValidationItemResponse

required
locator string
elementType string
errors string[]

Get a stateless validation preview for a hypothetical transaction

transactionValidatePreview

PATCH /policy/{tenantLocator}/policies/{locator}/{transactionType}/validatePreview

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
transactionType	path	string	required
baseLocator	query	string?	optional

Request:oneOf<AddChangeInstructionCreateRequest, DeleteChangeInstructionCreateRequest, ModifyChangeInstructionCreateRequest, ParamsChangeInstructionCreateRequest>[]
Response:PolicyTransactionResponse
Security Group:policies   Permission:read

Pricing

Price a Transaction

priceTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/price

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
stateless	query	boolean?	optional

Response:TransactionPriceResponse
Security Group:transactions   Permissions:write,price

Fetch Pricing for a Transaction

fetchTransactionPricing

GET /policy/{tenantLocator}/transactions/{locator}/price

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:TransactionPriceResponse
Security Group:transactions   Permission:read

TransactionPriceResponse

required
locator string
policyLocator string
effectiveTime datetime
transactionState Enum draft | initialized | validated | earlyUnderwritten | priced | underwritten | accepted | issued | underwrittenBlocked | declined | rejected | refused | discarded | invalidated | reversed
transactionCategory Enum issuance | change | renewal | cancellation | reinstatement | reversal | aggregate
charges PolicyChargeResponse[]

optional
validationResult ValidationResult?
aggregatedTransactions TransactionPriceResponse[]?

PolicyChargeResponse

required
locator string
elementLocator string
elementStaticLocator string
amount number
chargeCategory Enum cededPremium | commission | credit | fee | flatCededPremium | flatCommission | flatFee | flatPremium | flatTax | invoiceFee | none | nonFinancial | premium | surcharge | tax
chargeType string
handling Enum flat | normal | retention
invoicing Enum immediate | next | scheduled
rate number
referenceRate number

optional
reversalOfLocator string?
rateDifference number?
tag string?

Get a stateless price preview for a hypothetical transaction

transactionPricePreview

PATCH /policy/{tenantLocator}/policies/{locator}/{transactionType}/pricePreview

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
transactionType	path	string	required
baseLocator	query	string?	optional

Request:oneOf<AddChangeInstructionCreateRequest, DeleteChangeInstructionCreateRequest, ModifyChangeInstructionCreateRequest, ParamsChangeInstructionCreateRequest>[]
Response:TransactionPriceResponse
Security Group:policies   Permission:read

Underwriting

Underwrite a Transaction

underwriteTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/underwrite

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
stateless	query	boolean?	optional

Response:TransactionUnderwritingResponse
Security Group:transactions   Permissions:write,underwrite

TransactionUnderwritingResponse

required
locator string
policyLocator string
effectiveTime datetime
transactionState Enum draft | initialized | validated | earlyUnderwritten | priced | underwritten | accepted | issued | underwrittenBlocked | declined | rejected | refused | discarded | invalidated | reversed
transactionCategory Enum issuance | change | renewal | cancellation | reinstatement | reversal | aggregate
underwritingStatus string

optional
validationResult ValidationResult?
aggregatedTransactions TransactionUnderwritingResponse[]?
underwritingFlags UnderwritingFlagResponse[]?

Get a stateless underwriting preview for a hypothetical transaction

underwritePreview

PATCH /policy/{tenantLocator}/policies/{locator}/{transactionType}/underwritePreview

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
transactionType	path	string	required
baseLocator	query	string?	optional

Request:oneOf<AddChangeInstructionCreateRequest, DeleteChangeInstructionCreateRequest, ModifyChangeInstructionCreateRequest, ParamsChangeInstructionCreateRequest>[]
Response:TransactionUnderwritingResponse
Security Group:policies   Permission:read

Underwriting Flags

Update a Transaction's Underwriting Flags

updateUnderwritingFlagsForPolicyTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/underwritingFlags

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:UnderwritingFlagsUpdateRequest
Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permission:write

Fetch Underwriting Flags

fetchUnderwritingFlagsForTransaction

GET /policy/{tenantLocator}/transactions/{locator}/underwritingFlags

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permission:read

TransactionUnderwritingFlagsResponse

required
transactionLocator string
clearedFlags UnderwritingFlagResponse[]
flags UnderwritingFlagResponse[]

UnderwritingFlagResponse

required
locator string
referenceLocator string
clearedBy uuid
clearedTime datetime
createdTime datetime
level Enum info | block | decline | reject | approve
note string
referenceType Enum quote | transaction
tag string
taskCreationResponse TaskCreationResponse
createdBy uuid

optional
elementLocator string?

Add Approve Level Underwriting Flag for Transaction

addApproveUnderwritingFlagsForTransaction

POST /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/approve

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:UnderwritingFlagCreateRequest
Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permissions:write,approve-add

Add Decline Level Underwriting Flag for Transaction

addDeclineUnderwritingFlagsForTransaction

POST /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/decline

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:UnderwritingFlagCreateRequest
Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permissions:write,decline-add

Add Block Level Underwriting Flag for Transaction

addBlockUnderwritingFlagsForTransaction

POST /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/block

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:UnderwritingFlagCreateRequest
Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permissions:write,block-add

Add Reject Level Underwriting Flag for Transaction

addRejectUnderwritingFlagsForTransaction

POST /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/reject

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:UnderwritingFlagCreateRequest
Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permissions:write,reject-add

Add Info Level Underwriting Flag for Transaction

addInfoUnderwritingFlagsForTransaction

POST /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/info

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Request:UnderwritingFlagCreateRequest
Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permissions:write,info-add

Clear Approve Level Underwriting Flag for Transaction

clearApproveUnderwritingFlagsForTransaction

DELETE /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/approve/{flagLocator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
flagLocator	path	string	required

Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permissions:write,approve-clear

Clear Decline Level Underwriting Flag for Transaction

clearDeclineUnderwritingFlagsForTransaction

DELETE /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/decline/{flagLocator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
flagLocator	path	string	required

Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permissions:write,decline-clear

Clear Block Level Underwriting Flag for Transaction

clearBlockUnderwritingFlagsForTransaction

DELETE /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/block/{flagLocator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
flagLocator	path	string	required

Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permissions:write,block-clear

Clear Reject Level Underwriting Flag for Transaction

clearRejectUnderwritingFlagsForTransaction

DELETE /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/reject/{flagLocator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
flagLocator	path	string	required

Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permissions:write,reject-clear

Clear Info Level Underwriting Flag for Transaction

clearInfoUnderwritingFlagsForTransaction

DELETE /policy/{tenantLocator}/transactions/{locator}/underwritingFlags/info/{flagLocator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
flagLocator	path	string	required

Response:TransactionUnderwritingFlagsResponse
Security Group:transactions   Permissions:write,info-clear

Acceptance

Accept a Transaction

acceptTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/accept

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,accept

Issuance

Issue a Transaction

issueTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/issue

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
autoRebase	query	boolean?	optional

Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,issue

Documents

Fetch Documents for Transaction

fetchDocumentsForTransaction

GET /document/{tenantLocator}/documents/transaction/{locator}/list

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
offset	query	int?	optional
count	query	int?	optional
extended	query	boolean?	optional
suppressRenderingData	query	boolean?	optional

Response:DocumentListResponse
Security Group:documents   Permission:read

Fetch Documents for Segment

fetchDocumentsForSegment

GET /document/{tenantLocator}/documents/segment/{locator}/list

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
offset	query	int?	optional
count	query	int?	optional
extended	query	boolean?	optional
suppressRenderingData	query	boolean?	optional

Response:DocumentListResponse
Security Group:documents   Permission:read

DocumentInstanceResponse

required
locator string
referenceLocator string
documentInstanceState Enum draft | dataReady | ready | dataError | renderError | conversionError
external boolean
referenceType Enum quote | policy | invoice | transaction | segment | term
createdAt datetime
consolidatedFrom string[]
consolidatedTo string[]
metadata map<string,object>
renderingData map<string,object>

optional
policyLocator string?
termLocator string?
transactionLocator string?
segmentLocator string?
referenceDocumentLocator string?
staticName string?
name string?
category string?
documentFormat Enum? text | html | pdf | jpg | jpeg | doc | docx | xls | xlsx | csv | txt | zip
processingErrors string?
readyAt datetime?
createdBy uuid?

Transaction Details

Fetch Preferences for a Transaction

fetchPreferencesForATransaction

GET /policy/{tenantLocator}/transactions/{locator}/preferences

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:PreferencesResponse
Security Group:transactions   Permission:read

Fetch Affected Transactions

fetchAffectedTransactions

GET /policy/{tenantLocator}/transactions/{locator}/affectedTransactions

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:AffectedTransaction[]
Security Group:transactions   Permission:read

AffectedTransaction

required
locator string
action Enum reversed | reapplied | invalidated

Atypical States and Operations

Reset a Transaction

resetTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/reset

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
resetToDraft	query	boolean?	optional

Request:ResetOptions
Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,reset

ResetOptions

required
deleteAllAutomaticDocuments boolean
discardSchedules boolean
resetAllUnderwritingFlags boolean
resetFlagsAction Enum clear | delete
deleteDocuments string[]
resetFlags string[]

Note

If the query parameter resetToDraft is true, then the transaction will revert to draft state and the generated segment data, including elements and data, will be discarded. If false (the default), then the transaction will revert to initialized state and the segment data will be retained. This is useful to preserve the locator data for generated elements.

Refuse a Transaction

refuseTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/refuse

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,refuse

Discard a Transaction

discardTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/discard

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,discard

Invoke the precommit plugin for a draft or initialized transaction

precommitTransaction

PATCH /policy/{tenantLocator}/transactions/{locator}/precommit

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:PolicyTransactionResponse
Security Group:transactions   Permissions:write,precommit

Deprecated Items

Fetch Affected Transactions for List Endpoint

Deprecated

fetchAffectedTransactionsForListEndpoint

This endpoint will be removed in a future release.

GET /policy/{tenantLocator}/transactions/{locator}/affectedTransactions/list

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:AffectedTransaction[]
Security Group:transactions   Permission:read

Fetch Transaction Segments

Deprecated

fetchTransactionSegments

This endpoint will be removed in a future release.

GET /policy/{tenantLocator}/transactions/{locator}/segments/list

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required

Response:SegmentResponse[]
Security Group:transactions   Permission:read

Fetch Policy Segment Ex

Deprecated

fetchPolicySegmentEx

This endpoint will be removed in a future release.

GET /policy/{tenantLocator}/transactions/{locator}/segments/{segmentLocator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	required
segmentLocator	path	string	required

Response:SegmentResponse
Security Group:transactions   Permission:read