workflow.underwritingDecision.list

Retrieve a list of underwriting decisions of the workflow.

POST http://api.kompliant.com/workflow.underwritingDecision.list (OpenAPI specification)

Usage Info

This method retrieves a list of all underwriting decisions of the workflow provided.

Request

Authentication: KSig1-HMAC-SHA256

Parameters

ParameterTypeRequiredDescription
workflow_idstringYesThe identifier for the Workflow.

Example

{
  "workflow_id": "w_34lLDuJYFcWC5usyDLissC"
}

Response

Data

ParameterTypeDescription
workflow_idstringThe identifier for the workflow.
subject_record_idstringThe identifier for the subject record.
underwriting_decisionsarrayList of underwriting decisions of the workflow.

Underwriting Decision Parameters

ParameterTypeDescription
underwriting_decision_idstringThe identifier for the underwriting decision.
statusstringThe status of the underwriting decision. Must be one of UNDERWRITING_DECISION_STATUS
decisioned_bystringThe identifier of the entity that made the decision
decisioned_atstringThe date-time when the underwriting decision was made.

The value will be in ISO 8601 date and time format (YYYY-MM-DDTHH:mm:ss.SSSZ).

Example

{
  "meta": {
    "status": "SUCCESS",
    "version": "2025-03-24",
    "trace_id": "trc_5eWBWA2eCsP9vABdMaUIFc"
  },
  "data": {
    "workflow_id": "w_34lLDuJYFcWC5usyDLissC",
    "subject_record_id": "sr_62vXqvloRUbDaOch6nqBnS",
    "underwriting_decisions": [
      {
        "underwriting_decision_id": "c6543799-47f0-44aa-8c6e-4de941c2f41b",
        "status": "APPROVED",
        "decisioned_by": "AuthUser",
        "decisioned_at": "2026-01-22T08:23:31.853Z"
      },
      {
        "underwriting_decision_id": "71bea336-bb39-4607-89cb-57832ac575ba",
        "status": "PENDING_REVIEW",
        "decisioned_by": "DecisioningRuleSet",
        "decisioned_at": "2026-01-22T06:58:35.736Z"
      },
      {
        "underwriting_decision_id": "834f5e48-3da7-4cec-bb90-eb23234a924b",
        "status": "PENDING_REVIEW",
        "decisioned_by": "DecisioningRuleSet",
        "decisioned_at": "2026-01-22T06:56:12.219Z"
      }
    ]
  }
}

Errors

Error CodeHTTP CodePossible Cause
BAD_REQUEST400Required parameters not provided.
Invalid values provided.
ENTITY_NOT_FOUND 400The workflow_id provided does not exist.