Jobs API

Endpoint Index

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
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
Fetch Invoice Jobs for Quotes	GET /billing/{tenantLocator}/jobs/invoices/quotes/{locator}/list
Fetch Invoice Jobs for Policies	GET /billing/{tenantLocator}/jobs/invoices/policies/{locator}/list
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

Documents Jobs

Fetch Documents Job for Transaction

fetchDocumentsJobForTransaction

GET /document/{tenantLocator}/documents/transaction/{locator}/jobs/{jobLocator}

Request Parameters:

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

Response:DocumentsJob
Security Group:documents   Permission:read

Fetch Multiple Documents Jobs for Transaction

fetchMultipleDocumentsJobsForTransaction

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

Request Parameters:

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

Response:DocumentsJobSummary[]
Security Group:documents   Permission:read

Fetch Documents Job for Segment

fetchDocumentsJobForSegment

GET /document/{tenantLocator}/documents/segment/{locator}/jobs/{jobLocator}

Request Parameters:

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

Response:DocumentsJob
Security Group:documents   Permission:read

Fetch Multiple Documents Jobs for Segment

fetchMultipleDocumentsJobsForSegment

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

Request Parameters:

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

Response:DocumentsJobSummary[]
Security Group:documents   Permission:read

Fetch Documents Job for Quote

fetchDocumentsJobForQuote

GET /document/{tenantLocator}/documents/quote/{locator}/jobs/{jobLocator}

Request Parameters:

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

Response:DocumentsJob
Security Group:documents   Permission:read

Fetch Multiple Documents Jobs for Quote

fetchMultipleDocumentsJobsForQuote

GET /document/{tenantLocator}/documents/quote/{locator}/jobs/list

Request Parameters:

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

Response:DocumentsJobSummary[]
Security Group:documents   Permission:read

DocumentsJob

required
locator locator
referenceLocator locator
completedAt datetime
documentTrigger Enum validated | priced | accepted | issued | underwritten | generated
processingErrors string
referenceType Enum quote | policy | invoice | transaction | segment | term
status Enum finished | failed | running
createdAt datetime
createdBy uuid
childrenJobs locator[]
documents DocumentJobInfo[]

DocumentJobInfo

required
locator locator
staticName string
name string
documentInstanceState string
processingErrors string
state string (deprecated)

DocumentsJobSummary

required
locator locator
referenceType Enum quote | policy | invoice | transaction | segment | term
status Enum finished | failed | running

Note

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.

Job Retrigger

Trigger Timed Out Documents Job for Transaction

triggerTimedOutDocumentsJobForTransaction

POST /document/{tenantLocator}/documents/transaction/{locator}/trigger

Request Parameters:

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

Response:DocumentsJobSummary
Security Group:documents   Permission:trigger

Trigger Timed Out Documents Job for Segment

triggerTimedOutDocumentsJobForSegment

POST /document/{tenantLocator}/documents/segment/{locator}/trigger

Request Parameters:

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

Response:DocumentsJobSummary
Security Group:documents   Permission:trigger

Trigger Timed Out Documents Job for Quote

triggerTimedOutDocumentsJobForQuote

POST /document/{tenantLocator}/documents/quote/{locator}/trigger

Request Parameters:

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

Response:DocumentsJobSummary
Security Group:documents   Permission:trigger

Installment Jobs

Fetch Installments Jobs for Quotes

fetchInstallmentsJobDataForQuotes

GET /billing/{tenantLocator}/jobs/installments/quotes/{locator}/list

Request Parameters:

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

Response:InstallmentJobData[]
Security Group:jobs   Permissions:read,list

Fetch Installments Jobs for Policy Transactions

fetchInstallmentsJobDataForTransactions

GET /billing/{tenantLocator}/jobs/installments/transactions/{locator}/list

Request Parameters:

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

Response:InstallmentJobData[]
Security Group:jobs   Permissions:read,list

InstallmentJobData

required
locator locator
latticeLocator locator
referenceLocator locator
completedAt datetime
installmentLocators string
jobStatus Enum finished | failed | running
jobType Enum createOrUpdate | invalidate | unbill
processingErrors string
referenceType Enum quote | transaction
createdAt datetime

Invoice Jobs

Fetch Invoice Jobs for Quotes

Deprecated

fetchInvoiceJobDataForQuotes

This endpoint will be removed in a future release.

GET /billing/{tenantLocator}/jobs/invoices/quotes/{locator}/list

Request Parameters:

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

Response:InvoiceGenerationJob[]
Security Group:jobs   Permissions:read,list

Fetch Invoice Jobs for Policies

Deprecated

fetchInvoiceJobDataForPolicies

This endpoint will be removed in a future release.

GET /billing/{tenantLocator}/jobs/invoices/policies/{locator}/list

Request Parameters:

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

Response:InvoiceGenerationJob[]
Security Group:jobs   Permissions:read,list

InvoiceGenerationJob

required
locator locator
invoiceGenerationScheduleLocator locator
generateTime datetime
completedAt datetime
jobStatus Enum finished | failed | running
processingErrors string
createdAt datetime
createdBy uuid
invoiceGenerationInstances InvoiceGenerationInstance[]

InvoiceGenerationInstance

required
locator locator
invoiceGenerationJobLocator locator
invoiceLocator locator
generateTime datetime
completedAt datetime
jobStatus Enum finished | failed | running
processingErrors string
createdAt datetime
createdBy uuid

Delinquency Jobs

Fetch Delinquency Grace Job

fetchDelinquencyGraceJob

GET /billing/{tenantLocator}/jobs/delinquencies/{delinquencyLocator}/list

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
delinquencyLocator	path	locator	required
offset	query	int?	optional
count	query	int?	optional

Response:GraceJobData[]
Security Group:jobs   Permissions:read,list

GraceJobData

required
locator locator
delinquencyLocator locator
jobStatus Enum finished | failed | running
updatedAt datetime
createdAt datetime

optional
outcome string?
processingErrors string?

Fetch Create Delinquencies Job Data for Invoice

fetchCreateDelinquenciesJobDataForInvoice

GET /billing/{tenantLocator}/jobs/delinquencies/invoices/{invoiceLocator}/list

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
invoiceLocator	path	locator	required
offset	query	int?	optional
count	query	int?	optional

Response:DelinquencyCreateJobData[]
Security Group:jobs   Permissions:read,list

DelinquencyCreateJobData

required
locator locator
invoiceLocator locator
dueTime datetime
jobStatus Enum finished | failed | running
updatedAt datetime
createdAt datetime
delinquencyLocators locator[]

optional
processingErrors string?