workflow.defenseDocument.getDownload

Get the download url for a defense document.

POST http://api.kompliant.com/workflow.defenseDocument.getDownload (OpenAPI specification)

Usage Info

Retrieve a the download url of a specific generated document.

This method is only supported for Workflows of type BUSINESS_UNDERWRITING.

Request

Authentication: KSig1-HMAC-SHA256

Parameters

ParameterTypeRequiredDescription
defense_document_idstringYesThe unique identifier of the Defense Document to request download url for

Example

{
  "defense_document_id": "wdd_7h1EpxerrZQyLnRC1EQ9Ck",
}

Response

Data

ParameterTypeDescription
defense_documentobjectThe defense document parameter defined in the table below.

Defense Document Parameters

ParameterTypeDescription
download_urlstringThe presigned url of the defense document.

Example

{
  "meta": {
    "status": "SUCCESS",
    "trace_id": "trc_6zNzQZHSf26V83BO3uW6dS",
    "version": "2025-03-24"
  },
  "data": {
    "defense_document": {
      "download_url": "https://mockurl.com/url",
    }
  }
}

Errors

Error CodeHTTP CodePossible Cause
BAD_REQUEST400Required parameters not provided.
Invalid values provided.
ENTITY_NOT_FOUND400The defense_document_id provided does not exist.
SYSTEM_EXCEPTION400System exceptions are described below

System Exceptions

When a System Exceptions error occurs, the response will include additional entity_type and sub_code fields to provide more specific information:

Entity TypeSub-codeDescription
DefenseDocumentDEFENSE_DOCUMENT_FAILEDThe generation for defense document failed and is not possible to generate an url for download.
DefenseDocumentDEFENSE_DOCUMENT_IN_PROGRESSThe defense document is not ready for download yet.