A message for our valued customers and partners: This site is retiring, including accounts and API keys, as we migrate to the new developer portal. If you use existing API keys you will be contacted with further migration instructions. Accounts and API keys are not shared between this developer portal and the new developer portal. We recommend you review the new portal's Get Started guide for details on registering a new developer account and requesting new API keys.

APIs exposed to external broker partners. Current offerings: Submission API

get submission

Method
Description

GET

Retrieve Submission Request by Request Id

https://test-apis.us-east-1.libertymutual.com/v1/partner/{partnerId}/submission-request/{submissionRequestId}

Obtain a Submission Request using the Request Id returned by Liberty Mutual in acknowledgement of receiving the Submisison.

quote proposal

Method
Description

GET

Retrieve Quote Proposal Presigned

https://test-apis.us-east-1.libertymutual.com/v1/partner/{partnerId}/submission-request/{submissionRequestId}/quote-proposal

Retrieve Proposal Details and Presigned URLs for quote proposal documents

uw assignment

Method
Description

GET

Retrieve Assigned Underwriter for Submission

https://test-apis.us-east-1.libertymutual.com/v1/partner/{partnerId}/submission-request/{submissionRequestId}/uw-assignment

(Sample implemented) Obtain the name and contact information of the Liberty Mutual Underwriter currently assigned to work a particular submission.

submit submission request

Method
Description

POST

Indicate that all data/documents were uploaded

https://test-apis.us-east-1.libertymutual.com/v1/partner/{partnerId}/submission-request/{submissionRequestId}:submit

Step 3: POST endpoint to indicate that all data and documents for a submission request were uploaded. This is the last step in submission request generation. Submitting will mark the submission request with a status of RECEIVED and will begin processing it. After this step is executed, no more documents can be uploaded and no more additional changes can be done.

POST

Send Submission to Liberty Mutual

https://test-apis.us-east-1.libertymutual.com/v1/partner/{partnerId}/submission-request

Step 1: Initial operation to send a submission to Liberty Mutual. The first step in submission request generation.

POST

Add Document to Submission Request

https://test-apis.us-east-1.libertymutual.com/v1/partner/{partnerId}/submission-request/{submissionRequestId}/document-upload

Step 2. Upload a document and associate it with a particular Submission Request Id returned from the POST Submission Request operation. File size limit for these documents is 10 MB. This step must be executed after the submission request data was sent to Liberty Mutual. Documents are uploaded one at a time, and after all documents are uploaded, the submission request will need to be submitted. Note: This endpoint is not our preferred approach for uploading documents and is therefore temporary. API consumers should move to supporting the use of presigned URLs and utilize /document-upload-url.

POST

Retrieve Document Upload Presigned URL

https://test-apis.us-east-1.libertymutual.com/v1/partner/{partnerId}/submission-request/{submissionRequestId}/document-upload-url

Step 2: Retrieve a presigned URL that can be used to upload a document (up to 5GB) to Liberty Mutual. The document will be associated with Submission Request Id returned from the POST Submission Request operation. This URL expires 15 minutes after its generation. Information on how to use the presigned URL can be found at https://stackoverflow.com/a/63915110. This step must be executed after the submission request data was sent to Liberty Mutual. Documents are uploaded one at a time, and after all documents are uploaded, the submission request will need to be submitted. Preferred approach for document upload that should be used whenever API consumers can support the use of presigned URLs.

status

Method
Description

GET

Retrieve Most Recent Status for a Submission

https://test-apis.us-east-1.libertymutual.com/v1/partner/{partnerId}/submission-request/{submissionRequestId}/status

Retrieve status information based on submission request id