Jobs API
| Action | Endpoint |
|---|---|
| Fetch Documents Job For Transaction | GET/document/{tenantLocator}/documents/transaction/{locator}/jobs/{jobLocator} |
| Fetch Multiple Documents Jobs For Transaction | GET/document/{tenantLocator}/documents/transaction/{locator}/jobs/list |
| Fetch Documents Job For Segment | GET/document/{tenantLocator}/documents/segment/{locator}/jobs/{jobLocator} |
| Fetch Multiple Documents Jobs For Segment | GET/document/{tenantLocator}/documents/segment/{locator}/jobs/list |
| Fetch Documents Job For Quote | GET/document/{tenantLocator}/documents/quote/{locator}/jobs/{jobLocator} |
| Fetch Multiple Documents Jobs For Quote | GET/document/{tenantLocator}/documents/quote/{locator}/jobs/list |
| Trigger Timed Out Documents Job For Transaction | POST/document/{tenantLocator}/documents/transaction/{locator}/trigger |
| Trigger Timed Out Documents Job For Segment | POST/document/{tenantLocator}/documents/segment/{locator}/trigger |
| Trigger Timed Out Documents Job For Quote | POST/document/{tenantLocator}/documents/quote/{locator}/trigger |
| Trigger Failed Document Job For Transaction | POST/document/{tenantLocator}/documents/transaction/{locator}/jobs/{jobLocator}/trigger |
| Trigger Failed Document Job For Segment | POST/document/{tenantLocator}/documents/segment/{locator}/jobs/{jobLocator}/trigger |
| Trigger Failed Document Job For Quote | POST/document/{tenantLocator}/documents/quote/{locator}/jobs/{jobLocator}/trigger |
| Trigger Failed Document Job For Invoice | POST/document/{tenantLocator}/documents/invoices/{locator}/jobs/{jobLocator}/trigger |
| Fetch Installments Jobs for Quotes | GET/billing/{tenantLocator}/jobs/installments/quotes/{locator}/list |
| Fetch Installments Jobs for Policy Transactions | GET/billing/{tenantLocator}/jobs/installments/transactions/{locator}/list |
| Retry Failed Transactions | POST/billing/{tenantLocator}/retryJobs/{policyLocator}/retryFailedTransactions |
| Fetch Invoice Jobs for Accounts | GET/billing/{tenantLocator}/jobs/invoicing/accounts/{locator}/list |
| Fetch Invoice Job | GET/billing/{tenantLocator}/jobs/invoicing/{jobLocator} |
| Fetch Invoice Job Data For Account | GET/billing/{tenantLocator}/jobs/invoices/accounts/{locator}/list |
| Fetch Invoice Lifecycle Job Data | GET/billing/{tenantLocator}/jobs/invoicesLifecycle/{locator} |
| Fetch Delinquency Grace Job | GET/billing/{tenantLocator}/jobs/delinquencies/{delinquencyLocator}/list |
| Fetch Create Delinquencies Job Data For Invoice | GET/billing/{tenantLocator}/jobs/delinquencies/invoices/{invoiceLocator}/list |
| Fetch Delinquency Event Jobs | GET/billing/{tenantLocator}/jobs/delinquencies/{delinquencyLocator}/events/list |
| Fetch Anonymization Jobs | GET/compliance/{tenantLocator}/jobs |
| List Deserialize Schedule Items Jobs | GET/policy/{tenantLocator}/deserializeJobs/{jobType}/list |
| Fetch Deserialize Schedule Items Job | GET/policy/{tenantLocator}/deserializeJobs/{locator} |
| Terminate Deserialization Job | PATCH/policy/{tenantLocator}/deserializeJobs/{locator}/terminate |
| Restart Deserialization Job | PATCH/policy/{tenantLocator}/deserializeJobs/{locator}/restart |
Documents Jobs
Fetch Documents Job For Transaction
fetchDocumentsJobForTransaction/document/{tenantLocator}/documents/transaction/{locator}/jobs/{jobLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
jobLocator | path | ulid | Yes |
DocumentsJobdocumentsreadFetch Multiple Documents Jobs For Transaction
fetchMultipleDocumentsJobsForTransaction/document/{tenantLocator}/documents/transaction/{locator}/jobs/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No | |
extended | query | boolean? | No | When false, returns a bare array. |
DocumentJobListResponsedocumentsreadFetch Documents Job For Segment
fetchDocumentsJobForSegment/document/{tenantLocator}/documents/segment/{locator}/jobs/{jobLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
jobLocator | path | ulid | Yes |
DocumentsJobdocumentsreadFetch Multiple Documents Jobs For Segment
fetchMultipleDocumentsJobsForSegment/document/{tenantLocator}/documents/segment/{locator}/jobs/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No | |
extended | query | boolean? | No | When false, returns a bare array. |
DocumentJobListResponsedocumentsreadFetch Documents Job For Quote
fetchDocumentsJobForQuote/document/{tenantLocator}/documents/quote/{locator}/jobs/{jobLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
jobLocator | path | ulid | Yes |
DocumentsJobdocumentsreadFetch Multiple Documents Jobs For Quote
fetchMultipleDocumentsJobsForQuote/document/{tenantLocator}/documents/quote/{locator}/jobs/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No | |
extended | query | boolean? | No | When false, returns a bare array. |
DocumentJobListResponsedocumentsreadRequired properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | DocumentsJobSummary[] |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
transactionLocator | ulid | |
segmentLocator | ulid | |
referenceLocator | ulid | |
completedAt | datetime | |
documentTrigger | Enum validated | priced | accepted | underwritten | issued | generated | |
isConsolidation | boolean | |
processingErrors | string | |
referenceType | Enum quote | policy | invoice | transaction | segment | term | |
status | Enum running | finished | failed | |
createdAt | datetime | |
createdBy | uuid | |
childrenJobs | ulid[] | |
documents | DocumentJobInfo[] |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
staticName | string | |
name | string | |
documentInstanceState | string | |
processingErrors | string | |
state | stringDeprecated |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
referenceType | Enum quote | policy | invoice | transaction | segment | term | |
status | Enum running | finished | failed | |
createdAt | datetime |
The /list endpoints above will return an empty array if the entity does not exist for the given locator. An HTTP 404 error will not be generated.
Retrigger Jobs
Trigger Timed Out Documents Job For Transaction
triggerTimedOutDocumentsJobForTransaction/document/{tenantLocator}/documents/transaction/{locator}/triggerParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes |
DocumentsJobSummary[]documentstriggerTrigger Timed Out Documents Job For Segment
triggerTimedOutDocumentsJobForSegment/document/{tenantLocator}/documents/segment/{locator}/triggerParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes |
DocumentsJobSummary[]documentstriggerTrigger Timed Out Documents Job For Quote
triggerTimedOutDocumentsJobForQuote/document/{tenantLocator}/documents/quote/{locator}/triggerParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes |
DocumentsJobSummary[]documentstriggerTrigger Failed Document Job For Transaction
triggerFailedDocumentJobForTransaction/document/{tenantLocator}/documents/transaction/{locator}/jobs/{jobLocator}/triggerParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
jobLocator | path | ulid | Yes |
DocumentsJobSummarydocumentstriggerTrigger Failed Document Job For Segment
triggerFailedDocumentJobForSegment/document/{tenantLocator}/documents/segment/{locator}/jobs/{jobLocator}/triggerParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
jobLocator | path | ulid | Yes |
DocumentsJobSummarydocumentstriggerTrigger Failed Document Job For Quote
triggerFailedDocumentJobForQuote/document/{tenantLocator}/documents/quote/{locator}/jobs/{jobLocator}/triggerParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
jobLocator | path | ulid | Yes |
DocumentsJobSummarydocumentstriggerTrigger Failed Document Job For Invoice
triggerFailedDocumentJobForInvoice/document/{tenantLocator}/documents/invoices/{locator}/jobs/{jobLocator}/triggerParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
jobLocator | path | ulid | Yes |
DocumentsJobSummarydocumentstriggerInstallment Jobs
Fetch Installments Jobs for Quotes
fetchInstallmentsJobDataForQuotesDeprecated/billing/{tenantLocator}/jobs/installments/quotes/{locator}/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No | |
extended | query | boolean? | No |
InstallmentJobDataListResponsejobsread,listFetch Installments Jobs for Policy Transactions
fetchInstallmentsJobDataForTransactions/billing/{tenantLocator}/jobs/installments/transactions/{locator}/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No | |
extended | query | boolean? | No |
InstallmentJobDataListResponsejobsread,listRetry Failed Transactions
retryFailedTransactions/billing/{tenantLocator}/retryJobs/{policyLocator}/retryFailedTransactionsParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
policyLocator | path | ulid | Yes |
ListPageResponseInstallmentJobDataretry-jobswriteRequired properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | InstallmentJobData[] |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
latticeLocator | ulid | |
referenceLocator | ulid | |
completedAt | datetime | |
installmentLocators | string | |
jobStatus | Enum queued | finished | failed | running | |
processingErrors | string | |
createdAt | datetime |
Required properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | InstallmentJobData[] |
Invoice Jobs
Normal Invoicing
Fetch Invoice Jobs for Accounts
fetchInvoicingJobsForAccount/billing/{tenantLocator}/jobs/invoicing/accounts/{locator}/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No |
ListPageResponseInvoicingJobDatajobsread,listRequired properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | InvoicingJobData[] |
Fetch Invoice Job
fetchInvoicingJob/billing/{tenantLocator}/jobs/invoicing/{jobLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
jobLocator | path | ulid | Yes |
InvoicingJobDatajobsreadRequired properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
accountLocator | ulid | |
invoicingData | oneOf<EarlyInvoicingGenerationData,ImmediateInvoicingData> | |
jobStatus | Enum queued | finished | failed | running | |
createdAt | datetime | |
invoiceLocators | ulid[] |
Optional properties
| Property | Type | Description |
|---|---|---|
completedAt | datetime? | |
processingErrors | string? |
Required properties
| Property | Type | Description |
|---|---|---|
accountLocator | ulid | |
currencies | string[] |
Fetch Invoice Job Data For Account
fetchInvoiceJobDataForAccount/billing/{tenantLocator}/jobs/invoices/accounts/{locator}/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No | |
extended | query | boolean? | No |
InvoiceGenerationJobListResponsejobsread,listRequired properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | InvoiceGenerationJob[] |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
invoiceGenerationScheduleLocator | ulid | |
generateTime | datetime | |
completedAt | datetime | |
jobStatus | Enum queued | finished | failed | running | |
processingErrors | string | |
createdAt | datetime | |
createdBy | uuid | |
invoiceGenerationInstances | InvoiceGenerationInstance[] |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
invoiceGenerationJobLocator | ulid | |
invoiceLocator | ulid | |
generateTime | datetime | |
completedAt | datetime | |
jobStatus | Enum queued | finished | failed | running | |
processingErrors | string | |
createdAt | datetime | |
createdBy | uuid |
Fetch Invoice Lifecycle Job Data
fetchInvoiceLifecycleJobData/billing/{tenantLocator}/jobs/invoicesLifecycle/{locator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes |
jobsreadRequired properties
| Property | Type | Description |
|---|---|---|
workflowJobLocator | ulid | |
contextData | InvoiceLifecycleJobData | |
workflowType | Enum LATTICE_AND_INSTALLMENTS_GENERATION | INVOICE_GENERATION | INVOICE_LIFECYCLE | PAYMENT_EXECUTION | DELINQUENCY_MORATORIUM_EXECUTION | |
createdAt | datetime |
Optional properties
| Property | Type | Description |
|---|---|---|
completedAt | datetime? |
Required properties
| Property | Type | Description |
|---|---|---|
invoiceLocator | ulid | |
results | InvoiceLifecycleResult[] | |
triggers | InvoiceLifecycleTrigger[] | |
triggersHistory | InvoiceLifecycleTriggerUpdate[] |
Optional properties
| Property | Type | Description |
|---|---|---|
processingErrors | string? |
Required properties
| Property | Type | Description |
|---|---|---|
comment | string | |
newTriggerTime | datetime | |
oldTriggerTime | datetime | |
triggerType | Enum autopay | due |
Required properties
| Property | Type | Description |
|---|---|---|
triggerTime | datetime | |
triggerType | Enum autopay | due |
Required properties
| Property | Type | Description |
|---|---|---|
resultLocator | ulid | |
resultType | Enum autopay | due |
Early Invoicing
Required properties
| Property | Type | Description |
|---|---|---|
accountLocator | ulid | |
installmentsToBeInvoiced | ulid[] |
Optional properties
| Property | Type | Description |
|---|---|---|
timezone | string? | |
invoiceDueTime | datetime? | |
invoiceThroughTime | datetime? |
Delinquency Jobs
Fetch Delinquency Grace Job
fetchDelinquencyGraceJob/billing/{tenantLocator}/jobs/delinquencies/{delinquencyLocator}/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
delinquencyLocator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No | |
extended | query | boolean? | No |
GraceJobDataListResponsejobsread,listRequired properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | GraceJobData[] |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
delinquencyLocator | ulid | |
jobStatus | Enum queued | finished | failed | running | |
updatedAt | datetime | |
createdAt | datetime |
Optional properties
| Property | Type | Description |
|---|---|---|
outcome | string? | |
processingErrors | string? |
Fetch Create Delinquencies Job Data For Invoice
fetchCreateDelinquenciesJobDataForInvoice/billing/{tenantLocator}/jobs/delinquencies/invoices/{invoiceLocator}/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
invoiceLocator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No | |
extended | query | boolean? | No |
DelinquencyCreateJobDataListResponsejobsread,listRequired properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | DelinquencyCreateJobData[] |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
invoiceLocator | ulid | |
dueTime | datetime | |
jobStatus | Enum queued | finished | failed | running | |
updatedAt | datetime | |
createdAt | datetime | |
delinquencyLocators | ulid[] |
Optional properties
| Property | Type | Description |
|---|---|---|
processingErrors | string? |
Fetch Delinquency Event Jobs
fetchDelinquencyEventJobs/billing/{tenantLocator}/jobs/delinquencies/{delinquencyLocator}/events/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
delinquencyLocator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No |
DelinquencyEventJobDataListResponsejobsread,listRequired properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | DelinquencyEventJobData[] |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
delinquencyEventLocator | ulid | |
delinquencyLocator | ulid | |
jobStatus | Enum queued | finished | failed | running | |
triggerTime | datetime | |
updatedAt | datetime | |
createdAt | datetime | |
updatedDelinquencyEventLocators | ulid[] |
Optional properties
| Property | Type | Description |
|---|---|---|
rescheduledByLocator | ulid? | |
cancellationType | Enum? cancellationRequested | rescheduled | tenantRetired | delinquencySettled | delinquencyHeld | |
cancelled | boolean? | |
processingErrors | string? |
Anonymization Jobs
Fetch Anonymization Jobs
fetchAnonymizationJobs/compliance/{tenantLocator}/jobsParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
request | query | FetchAnonymizationJobsRequest | Yes |
AnonymizationJobResponse[]compliancereadRequired properties
| Property | Type | Description |
|---|---|---|
jobLocators | ulid[] |
Required properties
| Property | Type | Description |
|---|---|---|
jobLocator | ulid | |
jobDetails | AnonymizationJobDetails | |
jobStatus | Enum initialized | running | suspended | completed | |
referenceType | Enum none | account | quickQuote | quote | policy | contact | fnol | payment | disbursement | |
updatedAt | datetime | |
assignedReferenceLocators | ulid[] |
Optional properties
| Property | Type | Description |
|---|---|---|
parentJobLocator | ulid? | |
processingErrors | string? | |
createdBy | uuid? | |
anonymizedReferenceLocators | ulid[]? |
Required properties
| Property | Type | Description |
|---|---|---|
assignedReferenceLocators | ulid[] |
Optional properties
| Property | Type | Description |
|---|---|---|
includeAcceptedQuotes | boolean? | |
problematicReferenceLocators | ProblematicReferenceLocators? | |
policyStatuses | Enum[]? pending | expired | cancelled | cancelPending | onRisk | delinquent | doNotRenew |
Required properties
| Property | Type | Description |
|---|---|---|
assigned | ulid[] | |
children | ulid[] | |
failed | ulid[] |
Deserialization Jobs
List Deserialize Schedule Items Jobs
listDeserializeScheduleItemsJobs/policy/{tenantLocator}/deserializeJobs/{jobType}/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
jobType | path | string | Yes | |
offset | query | integer? | No | |
count | query | integer? | No | |
state | query | string[]? | No |
ListPageResponseDeserializationJobdeserializeJobsread,listRequired properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | DeserializationJob[] |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
jobState | Enum initialized | running | interrupted | failed | completed | terminated | |
jobType | Enum scheduleItems | |
metadata | DeserializationRequestMetadata | |
retryCount | integer | |
updatedAt | datetime | |
createdAt | datetime | |
createdBy | uuid |
Optional properties
| Property | Type | Description |
|---|---|---|
processingErrors | string? |
Required properties
| Property | Type | Description |
|---|---|---|
referenceLocator | ulid | |
staticElementLocator | ulid | |
fileName | string | |
fileSize | integer | |
referenceType | string | |
params | map<string, string> |
Fetch Deserialize Schedule Items Job
fetchDeserializeScheduleItemsJob/policy/{tenantLocator}/deserializeJobs/{locator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes |
DeserializationJobdeserializeJobsreadTerminate Deserialization Job
terminateDeserializationJob/policy/{tenantLocator}/deserializeJobs/{locator}/terminateParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes |
voiddeserializeJobswriteRestart Deserialization Job
restartDeserializationJob/policy/{tenantLocator}/deserializeJobs/{locator}/restartParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes |
voiddeserializeJobswrite